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No application, no matter how many features it 
includes, can do everything. People and organizations 
spend thousands of dollars buying and upgrading 
software hoping to end up with a package that fills all 
their needs. 

There is an easier way 

FaceSpaiT" 3*0 is a cutting edge interface design 
and rapid application development (RAD) tool which 
gives you the power to build and customize Macintosh 
applications quickly and easily 

Whether you want to create a simple floating tool 
palette that gives you quick access to your favorite 
scripts, have an idea for a new shareware program or 
need to tie together the functionality of multiple 
applications..* 

FaceSpan is the answer. 
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Features new to FaceSpan 3,0 allow you to: 


• Create interfaces and applications that 
conform to the Mac OS 8 look and feel* 


• Utilize new supported display objects 
such as tab panels, disclosure triangles 
and bevel buttons. 


• Define linkages that hide/show 
window items when anotlier item is 
hilited* 


• Develop hierarchical menus and 
assign command key modifiers directly 

• Edit all your project scripts with increased support for 
external editors such as Scrip ter™ and Script Debugged''. 

• Launch FaceSpan applications up to 5X faster. 

FaceSpan*" 

A Product of Digital Technology International 
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Scripting is Part of the Interface 

Wily do we need scrifiting languiigcw? Why do we need more 
than one? I started working in the Mac industry years before we 
hatl AppleScript. Back tlien, a few of the niom ]X)werful Mac 
applications had tlieir own built-in scripting languages^ including 
tlie coiiiniunications application I was working on. Then a 
scripting language was used to automate tlie internal functions of 
tlic application, freeing the user from having to watch over time- 
consuniing tasks, or just assisting with mundane, leticailivc work. 
We did not have anything like the shell script of Unix or tlie batch 
files of DOS to tie applications together, 

With the release of System 7, AppleScript entered the scene, 
Apple had given us a veiy powerful core language, with all tlie 
essential decision and flow control features. Unfortunately, 
Apple's original release of AppleScript was seriously flawed. The 
underlying technology was great, but A[i[ile didn't show us liow 
best to use it. ‘lliey were in such a huny to get AppleScript out 
ihe ckx^r, iha! they hadn’t had time to build it into the hinder 
Developers often Icxik to tlie Finder for ideas on how to Ix^st 
make use of Apple technologies, for better or worse. If we want 
an example of how the menu.s .should look in an application, we 
look to the Finder We do the same for ideas on the About box, 
Balloon Help and many other technologies. Apple did not 
provide developers with a rich example of how to ini[>lement a 
scripting interface to an application. Developers were slow to 
adopt AppleScript, and consc-ciuently, so were users. 

Designing a clean scrijiling inlerface to an application is a.s 
important as designing a clean graphical interface to the 
application. Yet few tlevelopers are willing to invest even a tenth 
the time in the scripting interface llial titey invest in the graphical 
interface. M{>st sciipting interfaces are implemented at the last 
minute, usually as the application is going to beta testers. By then 
there is not sufficient time in the development cycle to change 
the application to Ixfttei support scripting. Furtliennore, most 
scripring implementations are designed by ]>rogrammers, usually 
with intimate knowledge of the inner wwkings of the 
applicatkm. They think in leniis of the ap[)lic“aLion's miernal 
messages and data siructures and Figure they can use AppleScript 
to extend these to the user, i'hen the documentatic^n folks have 
to figure out flow to explain w'hai the programmers mean by 
commands like “OjxmConnectionToim\Server( serverAddress, 
portN umber, show Window V. 

Talk to your Mac 

1 prefer AppleJicript tecause writing in tlie AppleScript langLUigc 
is like talking to my computer. Reding the a.sncial geek that 1 am, I like 
the ideti of niy cornpulcT undersUinding me when I nilk to it. When 
I can say things like “Computer, please reU the ap[>licaiion “Finder’' 
to open the window' named "projects," Or, while in a QuickTime VR 


world: ''Computer, pan left 90 degrees.” Tlus sure Ixrats kiving to say 
'OpenFinderWindowC ''projects” AppieJiciipt provides a 
framcwcjrk for communicating with applications this way. 

'file biggest mistake Apple made with AppleScript was in 
not giving developers the "Human Scriprability Guidelines,” the 
AppleScript ec]iuvalent of the “Human Interface Guidelines.” 
After ail, AppleScript is an alternative interface to applications. 
For that interface to be easy to use, it must be well designed 
and consisieni with other applications. We ail know how much 
users benefit from consisLency across applications. Many of us 
fought liard to convince unenlightened developers who, in tlie 
early days of the Mac, neglected to include an Edit menu, used 
the wrong command key for “Close Window," put the 
Preferences item in the wrong tiieiiu, or otherwise made 
mistakes in the interface. Making applications scnptable 
requires this same attention to detail, but the problems are 
more subtle, and the soluiions le.ss obvious. Without Apple's 
guidance, we are left to figure out lor ourselves how best to 
design a scripting interface, and everyone designs a different 
look and feel. 

In my experience designing the scripting interface before 
designing the code helps a lot. This way, you can factor your 
application, building in well defined objects that easily map to 
your scripting terminology. To help you design your 
terminology, start by talking to your compiuer; vertially direct 
your application to perfomi common tasks. Ask users familiar 
with what your application to write the directions to 
common la.sks as if ihey were directing a eolleague to perform 
the task, Tliese activities will hel]) you identify the object that 
users think of when they perform these tasks. Those objects 
should f>e tile main elements of y{>iir terminology. This will 
also help you think al)out all the features you must have in 
your application, and how^ to organize the Linclerlying code. 
Then all you have to do is write it, ;-) 

In This Issue 

Two of the articles in this Issue can help you design better 
scripting interface.s your applications. John Schettino's look at 
prototyping applications with FaceSt>an provides suggestions 
on designing an application with scripting in mind. Cal Simone 
and Rill Cheeseman have designed a Iramework for judging 
just how scriptablc is an afiplication. Their ariidc identifies the 
essential features of any scnptable application. You also will 
find articles about scripting environments other than 
AppleScript. In today’s multi-plat form world, Perl and td/tk are 
important technologies. In the past, tlie Macintosh versions of 
these tools have not kept up with their Unix counterparts. This 
is no longer a problem. As you will see from the articles, these 
Macintosh tools arc very' powerful. Mi 
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by Dave Mark, ©1997, All Rights Reserved. 



Window-Related Events 


How a Mac program handles windows 


in last month's column, we covered the basics of event loop 
prograinining, focusing on four specific events: the mouseDown, 
tnouseUp» keyDown, and autoKey events, tf you liaven'i already, 
be sure to read through the Event Manager chapter in Inside 
Macintosh: Macintosh Toolbox Essentials. Pay specific attention to 
the sections that descnl>e die mcjuscDown, mouseUp, keyDown, 
and autoKey events in detail Finally, go back lo last montli's 
program and flesh it out a little. When a mouseDown occurs, 
draw a string in the event window that descrilx^s where and when 
the mouseDown (Kcurred. For a keyDown, draw die c:haracler 
and key codes emlx^dded in the EventRecord. 

In tlii.s month's column, we're going to expand our event 
handling repertoire, focusing on activate, update, and 
suspend/resutne events. 

A(tivatf. Events 

Every time your application creates a window, that window 
is added to a list maintained by the Window Manager. Tfie 
windows in this list are in the order that they appear on the 
screen, from the frontinost Uj ihe rearmexst. 

'Ihe frontmasi window is abo known as die active window. In 
Figure 1, Wintiow' starts off as the active window. Notice tile 
difference fx^twexm the title bars of the active and non-active winebw. 



When the mouse is'clicked in the rear window, Window #1 
is made inactive, then Uie rear window, Window #2, is made 
active. Since the front window is made inactive Ixfore another 
window is brought to the front, there will never he more than 
one active window at a timel 

Ihe Window Manager acajm[ilisiics tills liy sending your 
applic’ation a series of activate events. If a rear window is Ixtng 
t>roughi to the from, your application will receive two activate 
events. The first tells you that the fronlmosi window is becoming 
inactive. This event is also know'ii as a deactivate event. The 
second event tells your application that a window is becoming 
active. Both of these events set EventRecord.what to activateEvt, 

If a window is created, and ihcrc are no currently open 
windows, die Window Manager only generates a single activate 
event, indic^ating that the newly created window is becoming 
active. In diLs case, no deaciivaie event is sent. 

In general, you’il use activate events if you treat window 
conteriLs differently for an active window tlian for an inactive 
window. For example, your application might highlight seleaed 
text in the active window, but nut in an inactive windcjw. Activate 
events are provided for your benefit. Use diem as you see fit. You1l 
sec how we discriminate between an activate and deactivate event 
when we get to our pmgram later in die column. 

Update Events 

Next on our list of events is an event that tells your program 
to update the contents of a window. The updateEvt is generated 
when a window is created (after the activateEvt is generated) and 
when a new portion of a window is revealed. Figure 2 shows a 
typical sequence that generates an updateEvt. The first picture 
shows Window #^1 paniaOy obscuring Window #2. Next, Window 
'«^i is dragged to the left, revealing a previously hidden seaion of 
the Window ^2, The Window Manager sends an updateEvt to 
your application, telling it to update the contents of Window #2. 
The diird picture shows the window, after the program 
responded to the update event. 


Fijtfwre /, A mouse dick in Window #2 brings it to the front. 
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the right soP ware. 

Stufflt I iislallerMaker 4.6 picks up where your 
compiler stops. It allows you to easily create 
H custom ithsl allers for distributing software or .i 
files. Using our installer reduces technical 3 
W support calls due to end-user errors during 1 
^ installai.ion, .saves disks (if distributing on Poppies) 
or download time (if distributing on-line). 

Download a fllHl fully-functional copy ofStuini 
InslallerMaker 4.6 from www.alaridinays.eom, or 
call (408) 761-6200 and ask for Develoiter Salehs. 
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Suspend & Reslime Evxnts 

Whtn you click in a window belonging lo a backgnxind 
application, the active appi legation receives a suspend event, and 
the background application receives a resume event and is 
moved to the foreground. 

You might use suspend and resume events to determine ilie 
actions taken by your pmgram. For example, in the foreground, 
you might display a special tool palette, or perhaps nm an 
animation. When your application moves into tlie background, 
you’ll iieceive a suspend event and you might hide the tool palette^ 
or discontinue tlie aninxition until you get a resume event. 

It’s important to note that your application can continue 
Rinning, even if it retreives a suspend event. It will still continue 
to receive update (and ottier appropriate events) while in the 
background. At the very least, ifs a gtx>d idea to treat a suspend 
event as you would a deactivate event when it comes to the 
contents of your window's. Ftx example, if you usually deselect 
any selected text when a window Is deactivated, do the same 
thing for the aaive window w-hen you receive a suspend event 


figure 2, When Windoti^ is dragged to the iefi, more of 
Window #2 is exposed, earning an update etmit. 

Figure 3 shows a slightly different sequence, involving 
ufxiate and activate events. 'iTiis time, the mouse is clicked in 
Window ^2, bringing it it) the front. First, a deactivate event is 
generated for Window #1. Next, an activate event ts genejated 
for Window *^2. Finally, an update event is generated, asking the 
program to ujxlate tlie < ofirents of Window #2, 



Figure JL When Window ^2 is motfed lo ihe front, tuKi actimle 
enents and an update event are generated. 

Once again, you 11 see update and activate events in action 
tn tlie pnjgrani later in the column. 


Ar Last! The PKotiRAM! 

As promised, here's a program that incorporates all the 
events descnl>ed in this column. WindowMaster creates a single 
window and handles all die usual events relating to windows. 
Figure 4 shows the WindowMaster window in all its glory. Notice 
dial this window sports a close box, a zoom lx>x, a drag region 
(the title bar), and a grow box. Ihougli this window doesn't 
support scroll bai^, tlicre is room for them. In most cases, if a 
window has a grow box. it has room for .sctoII bars. 


Pin 128 sr 

• * * 

« 
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figure 4 The WindowAfasier window 

Creating the WindowMaster Resources 

Create a folder in your development folder named 
WindowMaster, Launch RcsEdii, then cmate a resource file named 
WindowMaster.rsrc m your WindowMaster folder. Youll create 
two rest:)urces in this file. 

First, create a WIND rcMJurcc according to the specifiaitions 
.shown in Figure 5, Next, select Set 'WIND' Characteristics... from 
die WIND menu and set the window's title to PICT 128, Next, 
copy a graphic from your ,scrapbcx>k into the cliplxiard. If you 
don't have anything interesting in your scraplKK>k, go draw 
something. HI wait. 
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^ww.micromacro 


Have you seen this man ? 

Hacker Harry and the pirate gang are 
loose and robbing the software stagecoach. 
Whether it’s software, bank account information, 
money transactions, or customer databases, 
if you want to stop them and collect your 
part of the reward... the place to find your 
New Generation Protection solution is at: 



The expected losses due to piracy in the software industry alone 
are over $15 billion for 1997. Some of this belongs to YOU. 
By using MicroGuard’s New Generation Copy Protection keys, 
you will enforce your rights and guarantee your profits. 









InierjiatiQnal 

Micro MafTf) Tcchn()k>gics, Ltd. 
3 Hashikma St. 
P.O.BaxI15I6,.4zur5S001 
Ismel 


MicroGuard 
631 Sourh Pontiac St, 
Denver, CO 80224 
US.\ 



Te!: (972 3) 558 23i> 

Fax: (972-3) 558^2344 
E-mail: mfc)@inicroniaao.com 


Tel: (303) 320-1628 
Fax: (303) 32(41599 
E-mail: u5a@micJomacn>.com 
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If you are running Mac OS 8, you can give your window the 
Mac OS 8 appearance with a few exira steps. First we have to 
configure ResEdit to sup[Xjrt a Mac OS B window. See the row of 
window icons across the top of Figure 5? Tiicsc icons select the 
window's pnxID, whic:h tells the system how to select and 
configure the WDEF tliat makes ilie window. Double click one of 
the icons ajntaining a questionmark shown at the end of the row. 
In file resulting window, enter 1031 m one of tlie emf>iy fields. 
Now one of your icoas will coniain 1031 as in Figure 5. Selea 
this icon. If you are doing this under Mac OS 8, you will see a 
Mac OS 8-sLyle window. You can experiment with other 
dCK'ument windtjw proclDs ranging from 1024 to 1031. These arc 
ail listed in AppeamnceJi of die Appearance Manager SDK. 

Onc:e yoiiVe got a ^phic in tlie clipboard, return to ResEdit and 
select Paste fiom the Edit menu. ResEdit will place your picture in a 
PICT resource. Make sure the PICT resi)urt:e has a resource ID of 128. 
Well, that's it for ResEdit. Quit, making suie you .save your changes. 
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Rather tlian [>rint ilie axk here twice, well go straight to die 
walk-through. You can type in die crxlc as we discuss it below 
and you will end up with the complete program, or you can save 
your fingures sonic effort and get the complete project from 
MacTech's ftp site <ftp://ftp.mactech.com/src/>. 

Walkinc; ThroitiH the Source Code 
Just like last monili’s prrjgram, WindowMaster is based on an 
event lcK)p architecture. Also, like last month's column, the program 
starts ofT by including <Sounds.h> to access the SysBeepO system 
Dill. Ihis month we add <l[mitH.h> to define SHRT_MAX. 

^include (limits.li> 

^include <Sound .li> 

^define kBaseResID 123 

tfdefine kMoveToFront (WindowPtr)-IL 

#defi»e kSleep 7 

#def Ine kScrollBarAd Ji:st (16*1) 

^define kLeav^iWhereTtls false 
j^/define kNotmalUpdates true 
^define kM3 nWindowileif^ht 50 

ildofine kMnWindowWidth 80 

gDone is initialized to false, tlien set to true when a click 
tjccurs in the window's close box. Note that this is not die way 
Mac applicatioas normally exit, bui we haven't got to menus yet, 
so a click in the close lx)X will have to do for now. 

(ilobaK """"7 

Baolean gDone: 


Figure f, SlK^tiJicaiiamfor WindowMasler's WIND n^source. 

Creating the WindowMaster Project 
Once you're out of liesEdit, launch Code Warrior and create 
a new project based on the Mac'OS:C/C++:Basic Toolbox 68k 
staiionary. Turn off ihe Create Folder check box. Name the 
project WindowMaster. mep and place it in your 
WindowMaster folder. Remove SillyBallsx and BillyBalis.rsrc 
from the project; we will not be using these files. From the 
Finder, drag and drop your Window Mas ter.rsrc file into the 
project window. You al.so can remove the ANSI Libraries 
group from the project, because we won't need them, either. 



Select New from the File menu to create a new^ window. 
Save it under the name WindowMaster.c, Select Add Window from 
the Project menu to add WindowMasier.c to the project. Your 
project window should look something like Figure 6, 


figure d WindowMasterlm>jeci uindow. 


As alway.s, the code includes pmtot)^pes for all fuficlion-s. 

r*””*“"*** .. KuntUon emoiYpi^ ”*7 

void Too lBoxInit( void J; 

void li/indowlnit [ void 

void EventLoopi void ): 

voidDoEventC Hv^;ntRecord 'ovontFtr j; 

void Hand!eMous^Down ( EveotRecoird •eventPtt ); 

void DoUpdatet EventRecord ‘eventPtc ): 

void DoPicture( WindowPtr window, PicHandle picture ); 

void DoActivateC WindowPtr window. Boolean beCoJ>ingActive }; 

void DoSuspendResumeC Boolean resuming ]: 

void CenterPict ( PicHandle picture. Reel ‘sircRectPtr, 

Sect MGstRectFt r ): 


main{) initializes the Ttxjlbox, erreates a window, then enters 
the main event loop. 

void main ( void ) 
f 

ToolBOKlnit0: 

Wlndowlnitf )i 

EventloopC): 

I 


ToolBoxInitO is the same as it ever was. 

r*"" .TixilBostillt V 

void ToolBoxlnit { void ) 

I 

InitGraft firqd.thePort }; 
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*^Withoui Or doubly the Premiere Resource Editor 
far the Mac OS ... A wealth of time-saving tools” 

- MacUser Magazine Eddy Awards 

'A distinct improvement over Apple's ResEdiL” 

- MacTkch Magazine 

**Every Mac OS developer should own a copy of Resorceren 

- Leonard Rosenthal, Aladdin Systems 

"^Without Resorcerer, our localization efforts would look like a ^ 

Tower of BabeL Don't do product without itr 

— Greg Galanas, CEO and President, Metrowerks 

""Resorcerer's data template system is amazing. '' 

- Bill Goodman, author of Smaller Installer and Compact Pro 

^'Resorcerer Rocks! Buy it, you will NOT regret it.'' 

— Joe Zobkiw, author of A Fnxgment of Your Imagination 

“Resorcerer will pay for itself many times over in saved time and effort." 
— MacUser review 

“The template that disassembles PlCTs is awesomer A 

- Bill Steinberg, author of Pyro! and PBTools 

“Resorcerer proved indispensible in its own creationr 
— Doug McKenna, author of Resorcerer 
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Version 2.0 



• Very fast, HFS browser for viewing file tree of all volumes 

• Extensibility for new Resorcerer Apprentices (CFM plug-ins) 

• New AppleScript Dictionary (‘aete'i Apprentice Editor 

• MacOS 8 Appearance Manager-savvy Control Editor 

• Power Plant text traits and menu command support 

• Complete AIFF sound file disassembly template 

• Big-, little-, and even mixed-etidian template parsing 

• Auto-backup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 68K versions 


New 

in 

2 - 0 : 


Requires System 7.0 or greater, 
1.5MB RAM, CD-ROM 


Standard price: $256 (decimal) 
Website price; $128 - $256 
(Educational, quantity, or 
other discounts available) 


Fully supported; it’s easier, faster, and more productive than ResEdit 
Safer memory-based, not disk-file-based, design and operation 
All file information and common commands in one easy*to-use window 
Compares resource files, and even edits your data forks as well 
Visible, accumulating, editable scrap 

Searches and opens/marks/selects resources by text content 
Makes global resource ID or type changes easily and safely 
Builds resource files from simple Rez-like scripts 
Most editors DeRez directly to the clipboard 

All graphic editors support screen-copying or partial screen-copying 
Hot-linking Value Converter for editing 32 bits in a dozen formats 
Its own 32-bit List Mgr can open and edit very large data structures 
Templates can pre- and post-process any arbitrary data structure 
Includes nearly 200 templates for common system resources 
TMPLs for Installer, MacApp, Q% Balloons, AppleEvent, GX, etc. 

Full integrated support for editing color dialogs and menus 
Try out balloons, Hetb’s, lists and popups, even create C source code 
Integrated single-window Hex/Code Editor, with patching, searching 
Editors for cursors, versions, pictures, bundles, and lots more 
Relied on by thousands of Macintosh developers around the world 


Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 


Payment: Check. PO's. or Visa/MC 
Taxes: Colorado customers only 


Extras (call, fax, or email us): 
COD, FedEx, UPS Biuemed, 


International Shipping 


MATHEMAiSTHKTICS, INC. 

PO Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
Fax: (303) 440-0504 
re sor cerer@mathemaesthetics, com 


To order by credit card, or to get the latest news, hug fixes, updates, and apprentices, visit our website. 


www.mathemaesthetics.com 














liiltFontsO r 
iaitWlDdowsO; 
InitMenus O; 
TEInitOj 

IiiitDialogs( nil ): 
InitCurenrO j 


WindowInitO calls GetNewWmdow() to load the WIND 
resource from the resource file. 

void WtndciwTniL( void ) 

I 

WindowPtr windowr 

window ^ GetI^ewWindow( kBs^eReslD, nil* kHoveToFtoiit ); 

If the resource wasn't found, Ix^ep once, ihen exit, 

if C window — nil ) 

( 

SynBenpt 10 ): T Couldn't load ihc WIND resource”!*/ 

ExltToSheilO : 

1 

Once the window is created, make it visible, then make il 
the current p<jrl* Notice that this routine does not do any 
drawing. Well draw our picture in response to an update event, 

ShowVindowC window )i 
SetPortl window ): 


EventLoopO sets gDone to hilse, then loops around a call 
to WaitNextEventO, If WaitNextEvent() returns tnie, the event is 
passed to DoEvent(). 

.. E\^ntljf>op 

void RvoniLoopt void 3 

I 

EventRecord event! 

gDone “ falEe: 

while ( gDone fal^e ) 

t 

if { WaltKejttEventt cveryEvent. frevent* kSleep. nil ) 3 
DoEvcnlt ievenr )i 

1 


DoEventO switches on the event's what field. 

.7 

VOidDoEvent( EventRecord •eventPtr 3 
i 

Boolean hecomlngAcLlve* reauming: 
fiwitch ( oventPtr >wbat J 

I 

A mouseDown event is passed to HandleMouseDown(). An 
updateEvt is passed on to DoUpdate(). 

case nouseDown: 

HundleHouseDownl eventPtr ): 
break: 

case updateEvt: 

DoUpdatet eventPtr ): 
break; 


In tlie case of an aciivate ei^ent, the event's modifiers field holds 
the key to whether tlie event is an activate or deactivate event. 


activeFlag is a mask that designates one of die bits in die rmxiiflerB 
field. If the bit is set, the event is an activate event, if the bit is clear, 
die event is a deactivate event The Boolean becomingActive is true 
the event is an activate event. Once becomingActive Ls set, it is 
pa.s.sed on to DoActrvateO. Ihe events message field holds a pointer 
to the window Ijeing atijvaied or deactivated. 

case actlvatcEvt; 

becomingActive ^ { teventPtr’)ttiodifiers & activeFlag) 
activeFlag 3 1 

DoActivate { (WindowPtr) evantPtr - >!ae9Sflge. 
becomingActive ); 

break; 

Similarly, an osEvt is used 10 indicate either a suspend or 
resume event, suspendResumeMessage is a predefined constant 
that designates the suspend/resume bit in the message field, 
resuming is set to true if the event is a resume event. Once set, 
resuming is passed on to DoSuspendResume(), 

case osEvt: 

roounihg = ( event Ptr->iaefisage & suspendResiuneHessage ) 
= resiimeFlag; 

J>oSu5pendResume( resulting 3: 

break: 

\ 

] 

HandleMouseDownO handle.s the mouseDown event. 

HandkModseDown 7 

void HaodlcMouaeDown( EventRecord ‘eventPtr 3 
I 

WindowPtr window: 

short thePart: 

GrafPtr oldPort; 

long winds l?:e: 

RecT growRec L: 

FindWindow (} takes the event's where field and returns 
the window at tliose ctx)rdinates. thePart indicates the part of the 
window the mouse click cxcurred in, 

thePart - FindWindowt everitPtr >where, /^window ): 

If the click was in a portion of ilie screen not lieUmging lo 
our application (like a desk accessoiy window), thePart is set to 
inSysWindow and well pass the event back to the system with 
SystemClrck(). 

switch ( thePart ) 

I 

case inSysWlndow : 

SyutGBCllrk( eventPtr. window ); 

break: 

If die event was in the ionieni region of the window, well 
typically call SelectWindowO to luring die window to the front. 
Since we only have one window, this line isn't particularly useful 
Later on tlusugh, you'll adti another window ro tliis program and 
you'll want to keep tills code in here. 

As your windows get more complex, you'll want to do 
more with inContent clicks than just select the window. You 
might have a button or .scroll bar in the window that needs 
action, or you might liave some text that needs selection. This 
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is the jumping off point for all dicks tliat occur in the window. 
Eventually, well add a routine named DoContentClick() to 
process clicks in a wind<jw's content region. 

case itiConrcnt: 

SelfictWrndow( window ): 
break; 


If the click was in the window's drag region (title Ixir), we’ll 
pass tlie window (retrieved by FindWindow()), and tlie mouse click 
coordinates to the Toollxjx muiine DragWindow(). 'Ihe third 
parameter is a bounding rectangle that detemiines where on the 
screen the window may be dragged, screenBits.bounds is a .System 
global variable that defines die Ixiundaries of the main display. 

If you have two monitors, this code works fine, htiwever. 
DragWindowO cliecks for screenBits.bounds as a panuneter and, 
if it finds it, allows dragging anywhere on any monitor 
attached to the system. 

case InDrag : 

DraftWindowt window* eventPLi: >where, 

Siqd*3crftenBita,botinds ): 
break; 

If die mouseDown was in the close box, well call 
TrackGoAwayO to see if the mouse was released while still inside 
the close box. If so, gDone is set lo true. TrackGoAwayO Is the 
routine dial d<x.*s the litrle animation in the close box. 

case iriGoAway : 

if ( TrackGoAwayt window ^ evf^ntPrr->whcrc ) ) 
gDone - true; 
break: 

if the click was in the grow lx>x* we set up a rectangle that 
defines how large and how small die window Is allowed to grow. 
Basically, it’s gtxxi policy to put a limit on how small a window 
can get, but, unless you’ve got a pressing reason, you should 
allow windows to get as laige as the user wants. 

case InGtow: 

growRect.top ' kMinl/lndowUeight: 
growR^ci.Icft ^ kMinWindowWidth: 
growRcct.bottom “ SHRT_HAX: 
growRcct.right = SHaT_HAX: 


Next, this a-clanglc Is pjissed on to GiwWindow(). whidi tracks 
the mouse, allowing tlie llsct to specify' the new w'indow size. 

vindSlzG GrowWini^owf window. eventPtr-)where* 
^grnwRpct ); 


The return value contains two 2T)yLe value.s, indicating the 
new height and width of the window'. If botli are zero, the user 
has not changed the wimlow size. 

if ( windSl?.c !- 0 ) 

I 


hirst, well save die current port (in case it's not this 
window), then make this window' die current port. Next, we 
erase the entire window' and change the window’s size l>y calling 
SizeWindowO The last parameter tells the system we want diis 
resizing to generate an update event. 
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GetPortC &oldPort 

SetPoctC window ); 

EraseEect( Swlndciw->portRect ); 

Si^eWindgw( window* LoWord( windSize 

HiWoird [ windSize ), kNormalUpdstas ): 

Next, we call lnvalRect() to tell the system that the entire 
window should be redrawn with the next update event, not just 
the new area revealed by the grow box. In fact, this call will force 
an update even if the window was shrunk. 

InV alR a e t{ ^window■> p o r t Rect ): 

Because we center our picture in the window, we need to 
redraw the window contents whenever the window changes size. To 
see why this is true, try commenting out the previous line of cxxie. 

Update events are tricky. It is definitely worth reading the 
section of Inside Macinlosh: Macintosh Toolbox Essentials that 
covers the Window Manager. You might also check out Chapter 
4's Updater program in Volume I of the Mac Primer. 

Once the window is resized, the port is set back to its old 
value. Since lnvalRecl() applies to the cufient pon, it was important 
that we make the window being grown the current port 

Set Pont oldPort ); 

) 

break; 

Finally, a dick in the zoom box follows a simikr strategy^ Again, 
TiackBoxO is called to verify ifiat the mouse was released inside the 
zoom box. If so, ZoomWindowO is called to zoom the window, or 
return it to its old position, depending on iLs current .state. 

case inZoo^Tn: 

case inZooBiOut: 

if ( TrackBox( windov, eveittPtr'>where, thePart ) ) 

r 

GetPort( SoldPort ): 

SetPort{ window }: 

EraseRectt &window‘>partR£*ct ) : 

ZooiriWindow( window* thePart, kieaveWhereltlfl ); 

InvalRectt &Tijindow->pottKect ): 

SetFort( oldPort J: 

1 

break: 

I 

I 


DoUpdateQ is called whenever an update event occurs. First, 
the window is retrieved from the event’s message field. Next, 
BeginUpdateO is called, telling the Window Manager that we’re 
handling updates for this window. BegirtUpdate() will re^trkt 
drawing to the region of tlie window that needs updating, also 
known as tlie update region. If you call lnvalRecl() on tlie whole 
window, the whole window is available for drawing. 

LtoUpdatc V 

void DoUpdateC EventRecotd ‘ev^ntPtr ) 

FicHandlo picture: 

Wind owPt r win d ow; 

window “ tWindowPtr)eventPtc >message: 

Bo§inUpdate( window J; 


Next, we load the picture and pass it on to DoPictureO^ 

picture - GetPicturet kBasGReelC }; 
if C picture nil ) 

I 

Sy sBeept 10 ); /* Couldn't load ilic PICT resource!!! V 
ExilToSbellO ; 

I 

Dopicture( window, picture ): 

EndUpdateC window ): 


DoPicture{) makes the window the current port, then erases 
the entire w^indow. Note that this will already have been done if 
the update event was caused by a resize or zoom, but there's no 
harm in this minor duplication of code. 

void OoPicturet tfirtdowPtr window. PicHandlo picture ) 

( 

Rect drawlngCllpRect* destRect; 

RgnHand 1 e t e mp Rp; 

SetPort[ window I: 

ErflBeRect( 5iwindow->portRect ): 

Next, a new region is created. We pass this region handle on 
to GetClip{), which places a copy of the window's clipping region 
in tempRgn. The dipping region defines which parts of the 
window can be drawn in and which parts can't. Again, it is a 
good idea to read die entire Window Manager chapter in Inside 
Macintash: Macintosh Toolbox Essmtiak as there's not enough 
space to cover all of it in this column. 

tempRgn = 53ewRgn(): 

GetGlipt tempRgn ): 

Since we want to center the picture in the part of the window 
not covered by the grow region and scroll bar areas, we’ll subtract 
those areas from ilic window’s portRea. Next, well pass this 
rectangle on to ClipRect() making it the new dip region. 

drawlngClipRect - window* > port Rec t: 

drawingCHpRect.right -- kScrollBarAdjust: 

d rBwingC1ip Re c t.hott om - kS c r 0 1IBa rAd just; 

CUpRect( SdrawingCl i pRect ); 

Next, we'll call CenterPict() to center the picture in 
drawingClipRect, returning the rectangle ihe picture should be 
drawn in as its third parameter. We then draw the picture with 
DrawPictureO. 

CenterPietC picture. ^drawingClipRect. ^destRect ): 

DrawPicture( picture, idestRecr 3 : 


Next, the clipping region is set back to its old value and the 
grow icon is redrawn, completing our update. 

SutClipC tempRgn ); 

Di&pa^eRgn( icmpRgn ): 

DrawGrowIcou{ window ): 

I 


It's important to remember that your application can receive 
update events even if it's running in the backgiound. If a foreground 
application’s window covers your application's windows and is then 
moved, the Window Manager will send your application update 
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events asking yon to redraw the adected windows. 

DoActivateO is prerty simple^ Ii rediaws the gniw icx)n in the 
specified window. DrawGrowlcon() will draw a diffenent grow icon, 
depending on whether your window is Ironmiost or not- When your 
application starts handling more dian one window, you’ll start making 
use of the second parameter, becomingActive. For now, we use the 
CodeWanior #pragma unused directive to let the compiler know we 
intentionally are not using this variable, Lf we didn't add this line, 
CodeWarrior would warn us ilrii the variable was never used. 

DoActivate */ 

void DoActivate( WindowFtr window. Boolean becomingActive ) 

1 

^pragma unused ( becomingActive ) 

DrawGrowIcont window )j 
I 

DoSuspendResumeO is also pretty simple. Tliis time die fronimost 
window's grow icon is redrawn A front window, which has been 
suspended gels the same gnw icm as any other window. 
DrawGrowIconO is smait enough to know the state of your application. 
Once again, as your programs get more complex, you’ll 
make use of the second parameter, resuming. 

DoSuspcndRcsumc 7 

void DoSuspendResumeC Boolean resuming ) 
f 

#pragras unused { resuming ) 

VindowPtr window; 
window “ FronLWlndowO ; 

DrawGrowlcon [ window ] : 
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CenterPictO centers the picture in the rectangle pointed to 
by srcRectPtr, returning the result in the rectangle pointed to 
by destRectPtr. 

^m,***m*m-.* 4..* antcrPict “““****-***-**-“/ 

vuid GsntGtFictt PicEaiidle picture. Rect 'srcRuctPtr. 

Rect ‘destRectPtr ) 
i 

Rent pictRect ; 

pictRect = i**i plcLutG )].picFrame; 

OffsetRucti fispictRect. srcRectFtr->left - pictRect,left. 

£ccRectPtr->top - pictRect.top); 

OffsetRectC StpictRect, 

fflrcRectPtr->right - pictRect.right)/2, 
[srcRectPtr->botToiri - pictRect. hortom)/?.) ; 

‘dcntRecLPtr ” picLRccL; 

) 

Rujnning WindowMaster 

Selea Run from the Project menu to run WindowMaster. A 
single window, like the one shown in Figute 4 should appear. 
Click tlic mouse in the title bar and drag the window anjund on 
the screen. Next, click in die grow box and resize die window. 
Try making it tall and skinny, then short and fat. Notice that dieie 
is a limit to how small you c:an make the window. Next, click the 
zoom lx>x in the upper“right corner of the window. The window 
should expand to fill the main screen. Click the zoom-box again 
to return the window to its previous size. 


Next, drag the window downwards, so it is halfway off the 
screen, oljscuring pari of die picture. Now drag it back up. The 
picture will be redmwn in full Finaily, click in the window’s 
close box to exit the progmm. 

Till Next Month 

Ihere’s a lot going on in this program. As IVe said before, 
do yourself a favor and read the Window Manager chapter in 
Inside Macinlosh: Madntmh TtTolhox E^eniiaLs. If a concept in 
this program seems Rizzy, try commenting out some of the code 
to see what happens. This is especially usehil with the code that 
affects or handles update events. You might also try commcnling 
out the calls to DrawGrowIconO just to see what happens. 

Finally, try' adding another window to the program. Add a 
second WIND and a sectmtl PICT resource l.o the resource hie, liien 
create die new window in Windowlnit(). You'll be amazed how easy 
it is to add a second window'. Go ahead, try it! B 


Visit MacTech* Magazine’s Web site! 
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SCRIPTIMC 


fy' Cal Simone and Bill Cheeseman 


The AppleScript Scorecard Guidelines 


Is your application truly 
scriptable? These 
guidelines may help you 
find the answer 


For users writing scripts in 
AppleScript, the number one challenge is 
the lack of intuiiiveness in scripting 
iniplementations and consistency when 
moving among scriptable applications of 
different types, 'i'o aid potential users of 
scriptable applications in dLicmiining the 
suitability of particular products for their 
scripting scenarios and, more imporumiiy, 
to promote these c*haracterisljcs among 
develo|X’rs of scTiplablc applications, a set 
of guidelines has l^een developed, in the 
fornn of an AppleScript "Scorecard". 

By the time you read this, the 
Catalog of Scriptable Products should i>e 
available on the Web, tentatively at 
<htTp://vvww.mainevenLcom/5corecard/>. The 
Catalog is a comprehensive directory of 
scriptable applications, and includes 
reviews and ratings. The guidelines pui 
forth in this article were developed to 
form the basis for the reviews and ratings 
found in the Catalog, 


Although the guidelines were develofx^d primarily as an aid 
for useis, tliey are offered here so that, as tlie developer of a 
scriptable produa, you can see, in broad terms, what makes op an 
application that delivers the ptwer of user -scripting into the Itands 
of users. Note that, at the Lime of writing this, we were close to 
completion, but the final point distribution had not been frozen. 

Even if you don't submit your application for a rating, 
following the criteria of this s<-oring system will guide you to 
making your application more* easily scripted and more consistent 
with otlier well-designed object rntxlel-based applications. 

The Guidelines 


These CJuid0:i^:^re, Copyright 1 997-199B,-khl 
Bill Cheeseman, <x)urtesy of MacTacb 

J998. The Gui^etmm may freely used dndf dis^^i^: 
provided that they are copied or di^iributed in 
mthaui aUeratmk and provided ibis fwtica is invimk^l !: • t::: 

To promrjtc fuD AppleScrif)! supjxjit in the widest range of 
produas, an application is rated in the AppleScript Scoreaird in 
part for the full and proper im pie mental ion of specific .scripting 
features, such as (he ol>ject model and recordability. To promote 
tile liighest quahty, an application is also rated on a more 
cjualitative assessment of the design, completeness, transparency, 
.stability and dotTimentaiicm of its Af^pleScripi implementation. In 
tile first phase of rating an application, a range of points is 
awarded for the pre.sence of sjx'cific features, taking into at:couni 
the extent to which each feature i.s implemented and its eonfonmty 
to Apple standards and conventions. In the sett>nd pM.se, 
additional j>oinLs are awarded on a sliding scale for specific overall 
qualities of the scripting implementation. 


Cal Simone <cal@saiplorg>, champion of ApjiieScript, is the President of Main Event Software <niaineveni@hLs.ci>rn> and the 
designer of Uie Scripier authoring anti development envimnment for AppleScript. In die first half of 1997, Cal .spearheatled a 
5-montli effort to rescue AppleScript from the chopping block during Apple's *teciinology evaluation’’ {also known as die 
“spring cleaning") and to ctmvince Apple’s top rminagement to commit to AppleScript in Rliapstxly. 

Bill Cheeseman <che€5eb^rTiediaone.net> Ls a lawyer in Mas.s:idiuseit.s, and he maintains The AppleScript Source Book site at 
<http://oasi's.bellevue.k12.wa.LJS/chee&eb/index.html>. A taie-life legal experience of his ts tlie subject of tire liesi-selltng lxx>k Civil 
Action," and it is being made into a Ilollywtxri movie, starring John Travolta, to lx released in late 1998. Bill lias been 
programming Apple conipiiicrs as a lujbhy .ntnee 1977. 
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The Apf)lcScript Scorecard rates an application's sup|3ort for 
Apf>leScript on a scale of 0 to 100, llie final score is converted 
to a scale of one to five ‘’.scripts'*, with lialf-scripLs (1-10 = 1/2 
script, tT20 - I strript, etc.). The “scripts” score is the primary 
rating for public distriliiiiion, but the points score am be 
published in parentheses (after convening it to a scale of 0.0 to 
10.0 with one dedtnal place). An example: “3-1/2 scripts (7.2)”. 

An ap[>Ucaiion is not considered scriptable, and it is not 
rated, if it has no dictionary or terminology^ (;aeie0 resource, or 
if it has a dictionary that su[)p>rts only the Required Suite (the 
run, t>pen, print and quit Apple events) and the ‘‘do script” event. 
Its Finder “scriptable" propeity may tnie because it does 
respond to tlie Rerjuirecl Suite, i;>ut this by itself does not reach 
the threshold necessary to l>c rated. 

To be considered for rating, therefore, an applit aiion musi 
implement a meaningful and reiLsonably useful set of verl)s in 
addition to those in Lite Required Huite (run, op^n, print and 
quiL), although not necessarily in the form of additioruil, named 
suites, Fven a small numlx^r of suppf>rted c:onimands suffices, as 
long as they enable a scripler to take advantage of some 
significant and useful functionality of the application. 'Ihc “do 
script" event, without more, does nor qualify (beouse this is a 
rating of the application's AppleScript features, not of a 
proprietary inienial scripting system.) 

Phase 1 — Scrifiing Feaiures Supported 

Points are awarded in Phase 1 for the presence of the 
specific ApplcScrijrt features described below. A range of points 
may be awarded for the presence of each feature to take into 
account the extent c>f its implementation and iLs conformity to 
Apple standards and conventions, but Phase 1 does not 
otherwise rale qualitative aspects of the application's 
AppleScript support. 

Implemenlaiion of any of these AppleScript features in 
confonnity to its description here merits awarding the m;tximum 
number of points for that feature. Points should be deducted 
from the maximum for failure to implement spedfk aspects of a 
feature where indicated. Points should also be subtracted for 
limiting a scripting feature such as the object model to a narrow 
subset of an application's functionalityi the penalty should Isc 
roughly proportional to the fraction of the application's 
functionality tliat is not covered by the scripting implemencation. 
The maximum score for complete implementation of all pcxssible 
scripting features is 40 poinLs. 

Object Model Support — supports the Apple event object 
model — 0 to 25 points 

The application sup|>orts tlie object model. Ii includes at least 
Uie essential verl>s in the Cone, or Standard, Suite (‘'nKike"^ “get” 
and “set,” at a minimum). It also implements a meaningfol set of 
objects that can contain other objetis and that have projxrrtics. 
The elements contained in objects liave a variety of reference 
forms (e,g., by index, by name, by unique tD) suitable to their 
intended use. Its supported commands, including new veii>s 
devised for the applicaiiCHi, can 0 [>erate on various objects and 


properties in objec:t mcxlel fashion. For example, instead of 
providing coimnands tliat are verl>noun hybrids like “GetColor", 
a graphics application might suppon objects of several classes, 
including “picture,” which can have any of several puspertics, 
inc luding “color," and commands tliat cun cjperate flexibly on any 
of those objects and properties to allow a scripter to create 
complex statements such as "make new picture with prcipenies 
[color:redl”, “get die color of die first ])icture” and “set the color 
of picture 3 to red.” The objects supported by an application must 
coniespond to all of the conceptual stnicturt:s of the application 
(windows, pictures and so on^ not its internal programmatic 
objects). 5 points should l'>e withheld if the application does not 
support the filter reference form ("whose” clauses). 

Recordable — supports recording — 0 to 5 points 

The application autoinaiically generates the text of valid 
AppleScript statements when actions arc recorded by a script 
editor. To receive the full 5 points, the generated script must 
lie executable without editing when run under the same 
conditions under which it was recorded, and its .statemenLs 
shouki be in general form (for example, they should not refer 
to objects by unique id). 

Attachable — supports a “Scripts" menu — 0 lo 5 points 

Tlie application lias a “Scripts” menu which lists 
AppleScripts written by the user and allows them to be rim from 
the menu bar. An application typically installs the scripts in die 
Scripts menti when the user places tficm in a folder within the 
application's folder. Withhold 1 point if the ScripLs menu does 
not support hierarchical menus (scripts insuilled in subfolders of 
the Scripts folder), and whhhold t point if the Scripts menu is not 
updated “on the fly" when a new seript is placed in the Scripts 
folder. Withliold 2 points if the menu has a name other than 
“Scripts” or its s 7 nonym in non-Fnglish systems. 

Embeddable — supports endiedding of scripts In the user 
mterface generally — 0 to 5 points 

Ihe application provides a means lo integrate user-written 
AppleScripts into die user interface in any of a variety of ways 
in addition to or instead of installing them in a “Scripts” menu. 
For example, scripts can be executed liy clicking on buttons on 
a tool palette, or scripLs can lx: run as background agents in 
response to events occurring in the application such as the 
launching of the application, the opening or closing of a 
wdndow' or the receipt of e-mail. The specific user inlcrface and 
the manner in which these scripts are stored is not specified and 
i.s not relevant to the score. To receive the full 5 points, the 
manner in which embetideci scripts are made available to die 
user should be creative, ct>nsi.stent with the user interface 
generally and easy to use. 

Phase 2 — Qualtit of SCRimNG Implementation 

In addition to the points awarded in Phase 1 for specific 
scripting features, additional points are awarded in l^hase 2 on 
the basis of the following cjualitaiive a.ssessmcnts of specific 
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aspect}^ of an application’s AppleScript support. In general, 
these categories rate the degree to which an application's 
AppleScript support forms a consistent and usehil user interface 
in its own right. 

An award of 0 points in any one category means that the 
implementation is abysmal in that respect; 2 or 3 points, that it 
is l>arciy useful; 6 points, that it is average and therefore 
acceptable; 9 or 10 points, that it is very good; and 12 points, 
that it is nearly perfect. In general, a conservative approach is 
taken so that room will be left at the extreme ends of the scale 
to distinguish the worst and the best implementations. An 
average score is not bad, and the scores of most applications 
should cluster around 6. A score of 4 or 5 points will not be 
uncommon for sliglrtly below average implementations, and 7 or 
8 points should be considered appropriate for good 
implernentaiions. The maximum score for quality is 60 points. 
To be awarded the full score, an application's AppleScript 
support should achieve all of the desired qualities in each 
category described here. 

Design — fidelity to the application's structure and 
function — 0 to 12 points 

The Application's commands, objects and properties, and the 
containment hierarchy and relationship of objects to one another, 
flow naturaDy from its subject matter and function instead of rigidly 
and slavishly mimicking its menu commands and dialogs, Tlie 
richness of the application is reflected in a relatively large number 
of objects, or nouas, and a relatively small numlijer of events, or 
verbs, that aa upon them. Commands and objeas from established 
suites, such as the Text Suite, are implemented faithfully if tlie 
application is one for which the suite is appropriate. For an 
application in an area diat has no established suites, its comimnds 
and objects reflect an equally appiopriate fidelid^ to the structure 
and function of the application. Consistency with good scripting 
implementations in tlic run of scriptabie applications in a panicular 
field is closely obseiYed or, if a new and different approach is 
taken, it is creative, imagin;itive and. above all. natural and intuitive 
— and still in keeping wiili the **look and feef' of standard 
Apple8crijM. Verbs and nouns that go beyond the standard features 
of established and well-designed suites must extend die language 
in a exmsistent and useful manner. 

Completeness — deptli, breadtli and thoroughness of 
senptability — 0 to 12 points 

The applic:ation implements a large number of cf>mmands, a 
wide array of objects having a deep containment structure, and a 
rich and extensive set of properties, exposing the application’s 
full complexity and oventil functionality through its scripting 
interface. The AppleScript implementation Ls thorough, detailed 
and complete, making all appropriate functions of the 
application available to the scripter. 

Transparency — resemblance to plain English words and 
syntax — 0 to 12 points 

AppleScripts written with the application’s dictionary are 


made up of simple English sentences. Common words in 
everyday use are employed in a familiar way to describe 
commands^ objects and properties. The application’s 
terminology and syntax are natural and intuitive, not awkward 
and obscure. A traditional computer programmer would think 
that an AppleScript statement written using the application's 
dictionary was a conceptual description of a script, not its 
executable code. A nonprogrammer would have a good 
chance of getting an AppleScript statement right the first time 
without lo<jking at the manual, and scripters experienced with 
the application would have little difficulty remembering how 
to script it. 

Stability — absence of bugs — 0 to 12 points 

The application’s AppleScript implementation is bug-free, 
and it works according to specification. 

Documentation — documentation and examples are 
provided — 0 to 12 points 

Instructions for most or all of die application's scripting 
features are provided, whether in print or on disk, llie 
documentation is clearly written, well organized and thorough. A 
large number of useful examples are provided. Apple Guide help 
(or anodicr help facility available within the application) covers 
the topic of scripting. Ihe scripting dictionary (‘aete’ resource) 
widiin the application has comments sufficient to remind a user 
familiar with the application how to use its commands and 
objecLs widiout die need to resort to die external documentation, 

Ge fiing Your Product ILited 

Send your application (including documentation), in a 
Stufflt archive, to <review@script.org>. Submitting to this address 
will cause the terms in your vocabulary to be added to the 
databases (both inside and outside of Apple) that are used to 
analyze and maintain the AppleScript language. This also 
submits your prodtict for review in the Catalog of Scriptabie 
Products, A submission form is also available in the Catalog’s 
w'ch area, tcniaiively < h tt p://www. main eve nt.co m/s corecard/>. If 
your application is large, has printed manuals, or Is 
packaged in a box, instructions can be found on the 
submission form for .shipping your prf>diict, manuals, or 
other maLcrials ft>r review. 

More Resources for Lmplemen iii^G Scriftabiuty 

A roadmap for achieving a thoughtfuIly designed and well- 
executed scripting implementation can be found in “According 
lb Script: Steps to ScriptabliJity’' in det>elop issue 24. 

Many of the .style guidelines, conventions, tips, and tricks 
(including tlic reasons for implementing the object model) are 
offered i[i “Designing a Scripting Implementation” in demhp 
issue 21, and the rest of the “According to Script” .series^ issues 
22-26 and 29. 

Details of the Apple Event Manager and OSA (Open 
Scripting Architecture) API are described in Inside Macintosh: 
Interapplicution Communication. 
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TECHNIQUES 


by John Schettino 


Rapid Prototyping 


An Object Oriented 
Approach to Using 
FaceSpan and AppleScript 
to Prototype Applications 


and ilica repeat tiie cycle. Each time through the cycle refine: 

* the requirements (what the application is suppo.sed tfi do.) 

• the interface (how the application kxjks) 

* the behavior (what tJie application does), and 

• the design Chow the application is stnictured) 


SOFTOARK DEVRtOFMJliNT 101 

Just the otlier day I read a posting to 
a Macintosh programmers news group 
that asked a simple hut powerful 
question. What design methodologies do 
most Macintosh programmers use? As 1 
stared at the phosphors of my monitor, I 
recalled my years of fonnal study in 
Software Engineering. I learned ail the 
state of the art (in the late 80s) software 
design methods when I wa.s getting iny 
Masters degree — but what do I actually 
use in practice? 

The answer is a bit surprising. It 
turns out that I usually use a Lcchniquc 
called either incremental development or 
rapid prototyping. This approach relies 
on my own expertise in ad-hoc design 
and the fact that Em usually working 
alone on a project. It doesn't hold op 
quite so well for large programmer 
teams. The basic idea is to quickly 
implement a subset of the application, 
use if — or better yet let the customer 
use it, see what works and wliitL doesn’t, 


For tiiLs approach to succeed, using tools tliat support very 
fast implementation of successive versions of the prototype is 
critical. Disc’arding die prototype once it has served iLs purptxse 
is also critical. This prevenLs overattaclunent to the initial 
version’s implementation. It also keeps me from over-polishing 
the prototype! For these reasons IVe selected AppleScript and 
FaceSpan as my Rapid Prototyping Environment. 

Tee Tools 

AppleScript is the Macintosh's bundled scripting language. Tt is 
a reasonable programming language for prototyping, since it 
includes b^isic block-programming constmets, subroutines, and 
several data types. It supports classes witli data and member 
functions, and fairly complex data strucl.ures. There is also a wide 
array of scripting additions on tlic Internet dint I use to round out 
tile language. AppleScript is close enough to Java, C, or C++ to 
dWow me to re-implement the prototype in any of rliose languages. 
It also reads a bit like p.sudcx:txlc .so iL can be used as a 
stK^dficaiion language for die final imjilementation. Tlie big plus 
for AppleSaipt is that it c^n call on thiid-partieii to perform 
complex tasks. That means ckitabases, emailers, text editors, and 
even the Finder can \x: called on to iKrform major portions of a 
prototyped application. The big minus with AppleScript is that it 
completely lacks any capabilities for interface creation. 

FaceSpan is a prodiKi from Digital Technology International 
dial works as an interface tool with AppleScript or other OSA 


John Schettino is an author and Senior Member of the ‘leclmical Staff at GTE Laboratories, Inc. He is die co-aa[ht>r of 
the books BASIC for tlie Newton: Programming for the Newton widi NS BASIC and AppleScript Applications: Biijlding 
Applications with FaceSpan and AppleScript, both published by AP Profe.ssional. He is aiso a contributing editor for the 
Handheld Systems Journal and for tlie web eZine Molrilis, where lie writes about Newton and WindowsCF. Vou can reach 
iiim via <hctp://meml>ers.aoi.com/pdcjohns>. 
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scripting languages, such as frontier. Using faceSpan 1 can create 
interfaces for AppleScript prototypes. Tht-‘ interface consists of 
several different styles of windows containing standard Macintosh 
interface elements. I then attach scripts to tlie windows and 
elemcmrs to process the events they generate. All the windows 
and scripLs are contained in a single pioject file. I run the project 
within the FaccxSpan environment while Tin developing it. Once 
it is w^orking correctly, I save tlie project as a stanckird Macintosh 
cxccuLal)lc file. In many ways iL*s simpler tlian it sounds. 

The conihillation of AppleScript and FaceSpan is similar to 
HyperCard with several key advantages. Most iinportani is the 
elimination of the Card/Background/Stack metaphor. In 
FaceSpan each window and it's window items behave as a unit, 
with their own meSxSage hierarchy, 'I'liis yields “Mac-like"* 
prototypes iastead of “HypcK^ard-like** prototypes. FaceSpan 
also fully supports colon QuickTime, Drag and Drop, and other 
key Mac technologies. It has a rich .set of interlace elements to 
choose from, !'ve done pretty fancy interfaces with FaceSpan, 
creating and desinrying window^ items on the !ly, implementing 
direct manipulation inteifaces, and so on. Some of the more 
interesting effects require a bit of script code, but at least that 
code i.s easily reused in other projects. 


because applic^ations that follow' the guidelines are easier for 
LiscTS to learn and use. The FaceSpan Window Editor is a great 
enviromiient to experiment with different layouts, but even more 
so, iFs a place where the developer can see first hand the effeas 
of following (or ignoring) tfie HCl guidelines. Here*s a .simple 
example. There are detailed rules for laying out the elements of 
a modal dialog box. *l'he first dialog box below follows these 
rules to the letter, the second does not. 



Sdue trianges ta the dotument before 
closing? 

[Bon'^t Saue] [ Caficel j 




Saue changes to the document before 
closing? 



[ Cancel ] 


The Method 

1 like methods. A mefhotl is a little less formal than a 
pr(x:edure. It is a general description of tlie .sLep.s needed to get 
somelliing done. If there is somellting in this methcKi that doe^^n’t 
work for you. then just work arounci it. 

The primary reason I develop a prototype is to refine my 
understanding of the application Fm creating. I also use it to get 
end-user feedback early in the design and implementation 
proces-s while it is ea.sy to make dtanges. llie method I u.se to 
meet these goals with FaceSpan anti AppleSt ript is (|uire simple: 

■ First, create the static portit>ns of the interface. 

• Second, add enough AppleScripi to animate the interface at 
the most basic level. 

• Finally, add imjie Ap]:)le.Script implentent as much of the 
application behavi(x as is needed for the prototype. 

This tliree-.step approach is not s|x?cific to FaceSpan and 
AppleScript. IFs the same method I u.se in any language. When 
using These tools ir is just a lor faster to complete each step. 
De|Kmding on the goal of the prot<aype it is tisually ptj.ssibic to 
stop before completing all three steps. For example, a 111 
designer might simply want to draw' a possible interface and add 
a bit of AppleStTipf to animate it. The prototype cotild then l>e 
handed over to users and its usability could Ix^ assessed. 

Drawing Interfaces in FaceSpan 

Begin with wdiaiever you know about itie de.sired 
application's look and Ixhavior and start aeating windows in 
FaceSpan. 'lbi.s is a g(x>d time to review the Macinto.sh Human 
Interface Guidelines, also known as the human-computer 
interface (HCl) guidelines. Fm a big fan of following tliesc, 


Figure L Conjorming and Non-confonning dialog boxes. 

Altliougli the two contain tlie same buttons, tlie first 
conforms to the HCl guidelines. The default push button Ls in the 
right location, there is a correct amount of white space between 
the window' items and the window border, and the icon is placed 
correctly. The result is a dialog box that is in.stantly recognizable 
to a Mac user. l-aceSpan encourages this tyjie of consistency 
throughout the application, but it by no mean.s enforces it, 

FaeeSpan's Window Editor creates three different typc.s of 
wiiidows. Doeumem windows are used for main windows. 
They can be resizr^ble, closeable, and zoomahle. Their optional 
lilies are di.stinct from their name, as used in scripus. Modal 
windows can be tilled or untitled and, unlike Document 
window's, must be closed before any other windows can 
receive events. The last wandow type Ls iloating Windoid. These 
are windovv.s that Hoai c>a top of all Dexumeat wmidow'S. They 
are usually used for tool palettes. 

A window contains zero or more window' items. The upper 
limit of window item.s i.s 330. There are 14 different types of 
window items, and these typos are further customizable using 
Eoims. For example, the Button window item can have either a 
sumdard or a 3-D visual represejitation. 

The Window' Ediior consisis of a pair of tool palettes. The 
window under construction is di.splayed almost exactly as it will 
appear. New window' item.s can be dragged onto the window^ 
or drawn on the window. Window items have several 
properties that control their beliavior. For example the visible 
and enabled properties determine if a particular window' item 
is visible, and usable. If its enable property is false, it displays 
in a grayed-oui style. 
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Figure 2. The faceSpan Windotv FdUor. 

Figure 2 shows a coniplex preferences Modal window in 
FaceSpan's window editor. This window uses several window 
items, including labels, lextlioxes, boxes, checkboxes, and 
buttons (called push buttons by FaceSpaa. ) 

In addition to the window^ editor, an application has full 
conuo! over the menu bar. Raskr menu capabilities are 
supported, as well as limited (single level) hierarchical menus. 
1'he menu bar support is the weakest portion of FaceSpan. 
Applications can have only a single menu item in the Apple 
menu and have no access to the Help menu. 

Animating the Interface 

There are three basic forms of interface lx:havion workflow 
control, feedback, and application specific behavior Tlie next 
step in pmTotyping is to implement the first two fomis. By 
tir>rkJJow conlrd I mean the degree to which the application 
controls wiiat the user can do at any given point in lime. This 
includes simple things like push button and menu sensitivity, as 
well as w indow inicractions. It also includes managing dependant 
window items, feedback is the use of visual and auditory 
messages in the application. For example, feedback Ls displaying 
a confirmation dialog box when the user closes a window, or 
playing a teep when invalid dam Ls enteied into a text f)ox. 

Ihe first step is to get the hill roiling at application startup. 
Let’s assume I have a pnxoiype that neecLs to open three windows 


when it is launched. I make a project in the FaceSpan environment, 
dniw three windows in the Window Editor, and then save the 
project as an executable. Wfien the user double clicks the 
appliction icon in tlie Finder, it launches just fine, I)liL no windows 
are displayed, I need to add some AppleScript to tlie project to link 
Lite launcliing event to several actions. When the user launches a 
FaceSpan application a run event message is sent to the project 
script, k the user drops a file on the application icon, an oix;n event 
mes.sage and a list of file references is sent to the project script 
instead. 1 w^ant to open direc windows when the user launches the 
application, so 1 add an on mn handler in the project script: 

on cun 

— get preffl 

sfit ipl, p2, p%] to storage item "positions'* 
open window "Call Wanager*" 
with properties lbountjls:pl 1 
open window "Status” 

with properties I position:p2, aoomed:false} 
open window “Call Manaj^er - driver" 

with properties Ipoaition;pi, zoomed;fatse1 
end run 

Most Macintosh applicaiitms keef> track of window p<xsiiions 
for the user 1 can do that for my prototy[>e as weU. This handler 
uses a storage item to keep track of user placement of the 
windows. Storage items are named containers where an 
application can store and recall any type of data. The actual data 
is kept in the resource fork of die application. Recall that this is 
tlie execiimble version of the project file. 

When the u.ser doulile dicks the application icon, the on mn 
handler of the prc:)jeci script is called. I f>egin liy recalling three 
positions (pexsitions are a FaceSpan datatype tliat specifies the x, 
y, width, and height of a window) from storage. 1 use each 
position to place and size eacli window exactly where the user 
left them when they last qitit the prototype. I open eacli window 
use the open window command, A Window is controlled by the 
settings of its properties, and 1 can set the values of window 
pro|>erties in tlie ojien window command using die with 
properties modilier, I use this to set the initial position of each 
window to the stored value. 1 need to create the initial values for 
the dircc positions and save iliem in the “p{)sitions” storage item 
within the FaceSpan environment. 1 also need to somehow 
capture the current !tx:arion and size of each window and update 
the storage item when the user c]uiLs the prototype. 

Once a window is open the user can interact with it. They 
can click buttons, enter text into textboxes, check checkboxes 
and radio ljutions, and so on. If there are no scripts attached to 
a window then these actions don't do anydiing specific to the 
prototype. Ihe window behaves like a fill-in-the-blanks form. All 
the window items and the window itself will work, but unless the 
prototype does something with the infonnation or actions the 
user takes, not much else will. FaceSpan does a lot of the hard 
work: the user can enter text into text fields, select radio buttons 
or checkmarks, Lai) l)eiwecn fields, scroll scrollable textboxes, 
and what not. What is missing is the applicution-specifk actions 
that link the whole interface together. 

For example, tlie modal dialog window in Figure 2 iias a 
checklx)x (displayed as a pull-down flag) labeled “Advanced 
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OptitjnN." Wficn tliL^ user toggles this checkbox “art" the window 
should cxixind to show the window items below it, and the OK 
push button should move tiown to the 1 k>uoitl Clicking it again 
should collapse the windt>w back to its original sixe and move 
the OK push button back to the original legation. When 1 dmw 
tile dialog window in the KaceSpan Window Editor I set the OK 
push button growth property U> move both. Tliat tells EaceSpan 
to move it in lx>ih directions whenever the window size changes. 
In effect it l:>ecomes attached to the lower right comer of ihc 
window. What ! want to do is resize the window between two 
fixed sizes, based on the setting of the Advanced Options” 
c:hecklx>x. I add a handler to the script atrachetl to the <:heckix>x 
that resizes the window' when the user changes the checklxix’s 
value. 'Iliat handler is very simple: 

on hllited theObj 
if bilite then 

Bet height of my vindov to 
else 

Bet height of my vindov to 345 
end 1 f 
hiH Led 

When the user clicks to push a button, checkbox* or ratito 
buinm window item the hilited event is sent to its attached sLrripL 
The hilite property of the checkbox is true if it is checked and 
false otherwise. This little ^script changes the window size to one 
of two sizes, based on the hilite propeny value, e^^ch rime the 
checklx)x is clicked. 



r create lot of die animation of a prototype interface using 
similar techniques. Handlers for push button clicks (on hilited) or 
listbox selections (on selection made) usually enable or disable 
otlier window items, open or close other windows, or enable or 
disalile menu items. 

W'hen the interlace is fully animated die [>rototy[3e Ls 
sufficient to answer a lot of questions about the final pitxlua. 
Docs the interface work well? Is it easy" to figitre out how k> 
accomplish a given task? Ts feedback clc^ar and consistent? Tlie 
final step for a pnUc^typc Ls to add some or most of the application 
S}x:ciric licliavior. This is both a valuable and a dangerous step. 
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Valuable because of what it can reveal about a potential design, 
and dangerous fx^caiise if the prototype Ix^comes loo funaionar' 
there is a real danger to ship it. By using FaceSpan and 
AppleScript, you are relieved of that danger, while still retaining 
the benefit of trying out a design l^efore committiag many hours 
to a C++ iiM piemen tali on. In other words, you’re pretty much 
assured of having to throw away the prototype! 

Adding Application-SpcciBc Behavior 

Adding application Ixiiiavior is pretty much an exercise in 
AppleScript programming, ’fhe FaceSpan message hierarchy 
provides a lot of flexibility^ in the placement of handlers for 
FaccSpan event messages as well as application specific 
handlers. My job is to convert the various FaccSpan event 
messages into application-specific messages. FaceSpan event 
messages signal interfac:e events (hilited, selection made, and so 
forth) while application-spccilic messages signal much higher- 
level events (produce a repoit, export to file, open database, and 
so on.) I then write handlers for those application-specific 
messages in AppleScript. This approach lets me reuse more of 
the design from the prototype because Tm able to separate the 
appliattion-speciflc portion.s of each handier fi'om the interface- 
sfxcific portions. If T go on to implement the final application in 
C++ or Java, the interface ctxle will l>e c|uiie different iluin 
FaceSpan. Ibe actual application specific behavior will also be 
coded differently, but the AppleScript code 1 write in tlte 
prototype can act as pseudocode. 

A simple example is a pusli l)ultDn in a window. When the 
user clicks the push button FaceSpan sends a hilited event 
message to its aiiached script, and then on io the window the 
buttoti is in, and finally to the jiroject script. The message flows 
along the mes.sage hierarchy until it is handled by a ,scTit>t, ,so I 
t'an plat:e the m liilited handler wherever it makes the most 
sense. My rule is to place the handler in the script attached to the 
window or window item closest to the item generating the event 
message, unle.ss a very similar action is perff)rme<.i regardless of 
whicTi window item is genera!ing it. For push biinons, 1 generally 
put the on hilited handler in the script aUached to the f>Lt,s[i 
button. This handler converts the FaceSpan event message 
{hilited) into an appIication-specific function call, Function calls 
in AppleScript send a user-dcTined command message 
corresponding to the function name into the message hierarcliy. 
Here’s an example script that converts a FnceSpan event message 
to an application-sjx-ciOc user-dellncd command: 

on hilited theOhj 

ai?T address ro eonients of textbox ’■digits” 

us isuing 

sendCalitaddress) 

set contents of textbox “digits" to 
end hilited 

Tht handler Ls front a proiotyfx Call Managemenl appli(iitif>n. 
In this prototype the niiiin window consists of a graphical 
ne[>resentaii<>n of a call, a lextliox named “digits”, and a push button 
lalx^led ‘"Send”. ^Jtllen die itser clicks Send, I want to extract the 
CLirrent phone number hum die textlx>x and place a telc(>hone c'all 


to dial numlxT. I dien want to c:lear the texttx)x. There are two 
different things happening here. Getting die phone numlxir and 
desiring the textbox are lx)di inreriace-specific actioas, so 1 take rare 
of tliem in lids handler. Tlie ,second action is placing a nil to the 
enteird nunibei. 'fliat has nodiing to do w ith die inLciface, and Td 
like to separate the code out ,so I can at leitst have the option of 
retLsing ihe design. I do this by c'jjlling a user-defined tunaion, lliis 
in eflect converts die FaceSyran hilited event message into an 
application-sj^xTific event message named ,sendCall(), Now all 1 have 
to do is implement the AppleScript handler for sendGallO. ITiLs 
handler Ls totally separate from die FaceSpan interface, and can be 
placed in a script anywhere along die message liicTarchy (window 
item, window, and project). Where this is placed depends on sev^eral 
factors, including the ultimate miger implejnentinion language. For 
diis prototype, I placed the handier in tlie project ,scripi: 

on sendCall(phoneNum) 

If isConnected Lhen 
lell window “Status" 

setMsg(“DiaI " & phoneNum} 
enableWaititigO 
end tell 

top wtite data "Dial “ phoneNiJiq 4 i LF "> 
fltreati tcpDlalogSocket 
end 1 f 
tMid aendCall 

In the handler 1 send a protocol message through a TCIVIP 
socket to a host application. I also enalile wdial amounts to a 
tliread in another window^ (again using an application-specific 
inessage named enableWaitingf)) that u.ses the FaceSpan idle 
handler to poll a TCP/IP socket ff>r a reply, fm taking advantage 
of the excellent shareware TCIVIP Scrii>ting Addition hy Mango 
Tree Software to perfomi the ICIVIP operations. 

r)f>n'r get too hung up on the actual code, what’s more 
imponani is to understand whai it slumps. Wlien 1 Implement the 
actual apfilication it's pretty clear thal the ccxle must write a 
string to a TCP/iP socket to make a call, and once ifs done this 
it must wail fora response. This design applies jusl as W'ell to the 
final application as it does to iliis prototype. 

Object Oriented Programming 
I generally take an objeet-orienied approadi to application 
design. FaceSpan and AppleScript fully support object-oriented 
implementations. For those not interested in f>r concerned with 
ol>jects, a purely functional approach can also be used, ff objecLs 
are important to the prototype, then there are several options 
available when using the FaceSpan/AppleScripi combination. 
FaceSpan’s windows and wintlow Items are themselves objects, 
wJiile AppleScript includes its own script objects. 

Objects in FaceSpan 

In FaceSpan. every window^ is ctmsidered a window template. 
1 his meaas that FaceSpan considers e%^eiy wuiclow, mcluding all its 
winefow items and attached scripts, to l>e a class of sorts. An 
a[)plkation c'an eiLher u.se the lempiate directly, or it can create 
several instances of tlie template. Each instance contains a complete 
copy of the window, including window properties and attached 
scrip! pro|Xiriies. F,ach windem^ instance is assigned a unitfue 
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windtjw id property, '[lie open window command opens a window 
leased on the teinpbtc omted in the Window Editor. 

Window items also are objects. They contain properties as well 
as data, and can be created and destroyed dynamically. Wlien a 
window is created in the Window^ Editor, the inituil set of window 
items is specified and their property values are set The application 
has cx)mplete control over these values, and can even override tliem 
when die window template is opened Ihe following code fragment 
dynamically creates several window items in a window* 

on displayGflll{calledNijmber♦ callc?dNiitnberId, 
isActive, isRadlo, isInConfH 
IsCoiif, lineFroni* riodeX, nodeY) 
local xFos. ypos, IconArt, lineProps 
set ypoa to (nodeY * 60) ' top 
set xPos tQ nodeX * BO 

if isRadio then 

set radioTteni to id of (make radio button ^ 
with properties Iposition: 14, yposl,width:16,'' 
height:16. script:none. hiliteiisActive. 
cnumrcaliedtJuDber* cld:calledNuflibetIdl ^ 
at end of window id theWindow) 
set index of window tten id rodioltera to 2 
end if 

set thelndex to “■ 

(index of graphic line "divLine") + 1 
if laConf then 

set iconArt to (class:resource info* ^ 
type:*'cicn‘\ name: "group" , Id: 5001] 

else 

set iconArt to (class: resource info. “■ 

type:*"ICON", nBine:"Big Off Tone'’, id:50021 
end if 

set iconitem to id of (niake icon with proportlee^ 

[artwork:iconArt. position:(4 + xPos. 
ypos - 10j. width:36, height:36. 
draggable:true. droppable:true, script:none. 
selection ruleras push button, 
balloon:"ISP Id is: " 6 calledNumberld, 
ciiuni:cailadKumber. ci!i:calledfliiinberld. 
conf:isInConf1 at end of window Id thoWindow) 
set index of window item id Iconlien to theludex 

if flineFrom • 1) then 

set lineProps to (position: {13. ypos + 81. 
width:80. height:!, script:none] 
else if (lineFrooi “ 0) then 

set lineProps to (position: U30 * {nodeX - IJ) 

+ 22. ypos ‘ 60], width: I, height :6&. 
script:none! 

else 

set IlneProps to 1 position:f(SO * lineFron) + 

14. ypos + 81, width:80 ' (nodeX - lineFroJa) 
height:!, script:none] 
end if 

set lineltetn to id of (make graphic line -> 
with properties ilneProps 
at end of window Id iheWindow) 
set index of window item id lineltem to theindex 

if (lineFrom “ 0) then 

set ilneltero to id of (make graphic line 

with properties I position:I(80 * (nodeX - !))-■ 

+ 22. ypos + 81. width: 72. height:!."* 
script;none] at end of window id theWindow) 
set index of window item id lineltem to thelndex 
end if 


This is a mcaty^ handler that creates several window items. It 
shows several intciesling tilings Fimt, the algorithm used to place 
the radio button, icon, label, and Uncs Ls rcasahle. 1 u.sed virtually 
the same algorithm in a Java and a New^onScript version of tlie final 
applicadon. Second, the applit^tion has total control over the 
placement and property values for window items it creates. Third, 
I’m adding applicahon-specific properties to the radio button and 
icon w'tnck)w items, I iLse these window items to hold information 1 
need faller number and conference information) to assfx^iate with 
the call, but don’t want to store separately. Finaliy, notice iliat each 
window item Ims its script property set to none. This is one case 
where I take advantage of tlte FaceSpan message hierarchy for 
pertbmiance neasons. Wlienever one of iliese window items 
generates an event message 1 can liandle it in the window’s aiiacljcd 
script witii a general handler. Here’s the hilited event handler: 

on hilited theObj 
try 

if class of tbeObj is radio btlttOTi then 
set theCallld to cid of theObj 
switchCalKtheCallld) 

end if 
on error 
end try 
end hilited 

1 dynamically create radio buttons, ictjns, grapliic lines, and 
lal>els as children of the window. Of these, only radio buttons and 
icons genemie ilie hilited event me.ssage. In tius prototype 1 don’t 
want to pertbnn any actioas if the user clicks one of the dynamic 
icoas, and there are no other radio buttons in the window except 
those I craite dynamically. When 1 add the on hilited hander to the 
script attached to die window, it is tailed whenever the user clicks 
something {radio button, checklxix, (lush button, or icon) in the 
window, but only If that window item does not include its own on 
liilited hander in iLs attached script. In this case I need to verify only 
that the class of the sender of die incssiige is radio button* If it is, 
then it must be one of my dynamically created ones. 

I usc^ the cliLss of operator to determine tf the object 
generating die message Ls a radio button. !f it is, then I convert 
the FaceSpan event message into an application specific message 
named swiichCalK). 1 retrieve the application specific property 
cid from the radio liutton, .since that's the id that the server 
process knows about. Tliis is an exuin[)le of ireailng window 
items like ohjecLs, since each item contains its own unique data. 

Objects in AppleScript 

AppleScript also has its own littlentsed ohject/class system. 
Each stTipt in AppleScript is con.sidered a Script object tliat 
contains methods (called handlers) and data (culled properties.) 
The script/end script command defines a script object within a 
script. The basic form is: 

script classNsmc 

properly parent: otherClassHame 


set labeliteoi to id of {aake label 


vith properties (position;IxPos i 10. ypos + "* property pi: value! 

241. width;so. height;16,contents:calledNumbet."* 

script: none I at end of window id theWindow) on hand lGr!i3ine( pa rams) 

set Index of window item Id labelltem to thelndex end 

end script 

end dJsplayCall 
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A script object can have zero or one parent script property, 
zero or more other properties, and zero or more handlers. This 
is mf>re like Java than C++ since there is only single inheritance. 
There is also no private or protected datii or methods. Everything 
is public. For prototyping, this is not a major hardship. 

Script objects are a little different tlian classes in tnosi 
ofiject-orientcd languages in that the script/end .script 
commands actually make a single instance. In the above 
example the commands make a single instance of the class 
named className. To make several instances of the class Fd 
have u.se the copy command to copy className, Instead of 
doing this, I can place the script/end .script commands in a 
handler Then the handler acts like a constnicion Every time I 
t:all the coostructur a new instance of the class is created. 
Parameters to the hander can be used in the property statements 
of the script to provide initial values to newly created objects. 
This Is an example of a simple coastmetor handler: 

on fliakoMyObj [name) 
script aayObj 

property myName: name 
on getNaineO 
return myKame 
end getNanie 
end script 

return myObj 
end 


Calling makeMyObjCFred'') returns an ins(anc:e of tlic myObj 
script object with iLs myName [^ro|Xirty initialized to “Fred"'. 

Combining script objects with FaceSpan allows for 
encapsulating all of the handlers and data ass(x:iated willi a group 
of dynamic: window items into one ohjecL I use tliis teclinique to 
bind all the iiictliods and data for a meeting in a meeting objea in 
an example in by book, AppleSaipt Applications: Bitilding 
Applications in FaceSpan and AppleSc:ript, in tlie DatcMinder 
application. This application implemcnLs a ?TM liiat includes a Day 
view. The Day view is a window that displays a cluster of three 
window items for each meeting in a day. Here is a portion of ilic 
constructor and script object for a meeting: 

on makeDaylLemtiLGinclciSB* itemDetaM b, itemNote) 
local poB, startAt, m(?GtiiigLeng,th 

if iteinciaBS “ “Heeting** then 

Bet Ipos, StartAt. meetingLengthl to itemDetaiis 
i]pdateCalendarMefitMarks(startAt, true) 

else 

set. surtAL to 0 
set meetlngLengLh Lo 0 
set pos to ItejJiCetails 

updateCalendarOtherMarks(itemclass♦ t rueJ 
end if 

script DayObject 

property theIndex : 0 
property barlndex : 0 
properly iconltidex : 0 
property textindex t 0 
property myPos : pos 

property myTime : startAt * 13 * minutes 
property myLength : meetingLength 
property myClaas : iteuclass 
property myNotea : IteriNote 


on getiteminfoO 



MkLinu 

Microkemet Linux for the Power Macintosh 


MkLinux is a complete system^ based on Linux 2 and the 
Mach 3 microkernel. It includes development tools (gcc, 
gdb^ perl, X11R63, and hundreds of other commands. 

MkLinux builds and runs most Intel-based Linux software 
It works efficiently and reliably on a wide range of Power 
Macintosh platforms* Visit Apple Computer’s MkLinux web 
site {www.mki jnux,app!e*com) and Prime Time Freeware's 
web site (www.ptLcom} to find out more about MkLinux! 

MacPerl: Power and Ease 

MacPerl is a robust and powerful port of Perl 5 to the Mac* 

It runs under the Finder and MPW,, supports Apple Events 
and Toolbox calls, and is generally quite nifty! For details 
on MacPerl and associated products (book, CD, etc*), visit 
the MacPerl Pages (www*p tf.com/macperl). 


Prime Time Freeware 
370Altair Way, #150 
Sunnyvale, CA 94Q86 


info@ptf.com 
(408)433-9662 
(408) 433-0727 fax 


if iLemclass = ”Meet 1 nz“ th^n 

return [ itemGlaiSs . xPos; myPofs 

starttime tmyTiine. duration imyLcngth, 
notes:ffiyNot€SI 

else 

return !itemclass:myClass^ xPos:myPos. ^ 
notes:myKotes| 

end if 

end getltemlnfo 

on resizeMeeting[theObj) 
end resizeMeeting 

on createTmageO 
end createTmage 

on updateMeetlngCnewTime* newDuration. newText) 
end updateMeeting 

□n move (thelnfo) 
end move 

on redraw!) 
end redraw 

on openWindowO 
end openWindow 

on closfiWindowO 
end closei^findow 

on winduwNainc() 
end vindowWame 

on updateWlndowO 
end updateWindow 

on ad opt D eta i 1 Win do w (o id Wi n d owM am e) 
end adopt Bet a 11 Window 
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Softt^^ 

HIGH PEBFORHANCB 



Imaging, Annotation & Plug-in 
"" Development Tools 

RdSterMaster 7.0 Powerful, multi-platform raster 
imaging support for 60+ Raster Formats, Familiar API and 
wetPprpv^en ^achnology in use worldwide by companies 
such a^ 8P, Cha^ Manhattan, Fprd, Gannett, HP, IMSI, Kodak, 
LEXtS-NEXis, Polaioid, ToyoVUnisys;Xerox and mom. 
Formats; Tli=-,JPEtS, MO;DCA, CALS, PNG/DiCOM. Flasbpix, 

^ BMFVBRK, G3vG 4, GfF, JED, KFX, MAC, iOCA, PCX, TGA, 
WFX and more. Features include: (* New for Version 7) 

CMYK 4 Plarie Support * 

Mmage Processing ; *10-16 bit Gray scale * 

DespeCkle & Deskew * Anti-Aliasing in Sih/er * 
Multipage TWAIN Scanriing Fit to Width & Height 7 

* Pan. Zoom, Scroll ^ - Tiled Image 

* fm^^EdiJihg . 

^ * 'Auto 'Asbectrf 


.. ‘Alpha Support Encryption 



r Medical imaging 
i^^Ani.mated.GIF '' 



2,0AnnbSi| 
Redi^ 






^,^lining. toolkit:. Featur®' -- 
pises, Ffedhand'D'rawlhg.^^^^^^^^ 

, Mu Iti p le Annotatfon layers. 

ip for Netscape and Intehij^ Explorer, 

I Simple drop In library makes it easy to 
to read your Intemet/lhfe^rfet pages. 
Mac eBKyPPO./yN®')^’;^a.^^ 
fe; DLL. VBX, ActiveX;OCX, Delphi, yc++ 

617-630-9495 Ob Visit Us 
iWbltd.com 


on updateltenText(newNote) 
end updatelt&mlGXt 

on updatelTemTexT.Andn i f:pl ay (ncwNote) 
end updnicltemTexLAndDisplay 

013 remove [) 
end remove 

end script 

return DayObject 

end makcDiiyUem 

1 c:ill the niakeD;iyItem() handler to create a day item object. 
Onc e if i.s createtJ I draw ids graphical repiescnration in the Day 
window by calling the creaLcimageO handler. An example of ihis 
Ls in the handler called when the user drags an icon onto the 
window^ to create a new meeting: 

tni newDayltern(theClasSi theinto) 
local theDayltem 
set theDayltem to 

makeDaylteraCtheClass. theinfo, "*') 
r.fit end of |■be|]nyTtoJns ro theT];^yTtei!i 
tell thcDsyUcfn lo crenIcTm^iac[) 
end newDayitem 


In this handler I create a new day item object by oiling the 
day item consiructor iiandler, and save the object in a list of all 
day items .stored in a propeity. 1 then call the createlniageO 
handler in the object to draw' the object in the w'indow. Any 
serif>l needing to access data associated with the object, or to 


change its conienLs or location, need call only handlers in the 
object. I don’t have to know how it is implemented, what 
window items are associated with it, or how to modify their 
properties. As 1 said, it’s a powerful combination. 

Moving From Prototype to Product 

Onex; the prototype is completed and ready to retire, 1 don'i 
just ignoredt. Ratlier it c'an l:)e mined for valuable infomiation. Hie 
interface will liave to be reimplemented in the taiget language 
(using PowerPlant, or the Constnittor for Java, or by hand axling, 
dcfX.mdiiig on die imf3leinenmtion language). The [>rototype serves 
two roles here; it acts as a guide when laying out the interface and 
as a sjTecification for naming the elements of the interface. 

The same holds tnie for the AppleScript scripts. They act as a 
high-level specification language for the final code. Algorithms 
implemented in AppleScript are highly reusable, as aie data 
stRicuires and class hierarchies, Tm not .suggesting that ifs just a 
mailer of ''fx jrling over" to C++ or Java, bul at Ic^isi I’ve already got 
a wtjrking solution to use wiien I'm doing the final implementation. 

Give Example oe a Prototype That Worked 

Hiis is not just some abstract article - five used tiiese tecimiques 
many times when cnetiting pnxotypes for G'FE bilx^mtories. Here at 
the lal^s fast turn aaxind times arc cTitical when we’re mex^king up 
Lif>[)licaLions. I!y using tlii.s metluxl and lliese UxjLs, IVe cieated 
many successful demas using AppleSaipl and FaceSpan. When we 
recreate a particular application in a pnKliKiion system, we firsi 
cupnire the design by dissecting the prototype. 

One such example is a Call Management client application 
ff>r an Internet teleph^>ny project, This iipplicafion drives a ser\^er 
front end to allow the iiser to create and manage many 
tciufihone calls. Calls can be [>laced, merged inR> conferences, 
and drtjjtped. l-urthermore the user can have many calls active 
at the same time. The ultimate tmplementation target for the 
clieni a[)f)liaiiion was Java, but tnucli of the protocol used to 
communicate between the client and server wa,s undefined and 
we needed a Lisable prototype in just two wrecks. LJsing the 
method outlined in ihis article, and ihe TCT/TP osax from Mango 
Tree Software, 1 was able to create a f^rofessional prototype with 
a rlireet manipulation interface. I’his prototype carried us 
through ihe demo, and ihen was used for the final Java 
application over the next twt> months. The running applkadon 
is sliown I^Mflow. 



Figure 4 
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As yt>u t:an seti, the application kx)ks and behaves like any 
other Macintosh ap[)licaUon. The icons cm ihe scrolling display 
support drag ik drop — just drag a [^ihone icon on lop of 
anolher to merge the calls intf) a conference, or drag a phone 
icon out of a confcTcnce and onto the main window to split that 
call out of the conference. 

l^uikling this prototype in KaceSpan and Appie.Script let me 
ftxms cjn the irnpomint details im luding c reating a layout algorithm 
for the call graph, finalizing and debugging tlie TCI*/IP pioicx.'oi 
lx‘iwc!en client and st^rver, and creating an enjcjyahle and usable 
interface lor rail manipulation, I didn't neetl (or have time) to 
,struggle with the details of exxiing tlie a|)plication in C+t or Java. 
Kven so, 1 was still able leverage the time Sfxmt on piotot\j:»e 
when building the final version in Java. I also rt^-impiementc\l it in a 
custom NewtonSciipt afij^lication* Even tiieie die dine spcmi on the 
prototype reiipt^d large rewards when designing the CVl in die 
Newton Texil kit and implementing the application in NeMonScTijx:. 

Protoitping Can Work Foh Yov 

There are ar least three g(x>d reasons to create a prototype 
Ixiore building an applk'atton, A protot>^pe can help answer 
tough questions alxiui an interface: how usable is it, d(x‘s it work 
better one way or anotJier. what is the optimal placement tif 
controls in a wnndoev. A prototyfx^ is usually ready to use in short 
order and can fill in for die final application while it is being 
wTitten, A prototype also lets you play "wliat iP gatucs with 
different algorithms and data structures, A.s long as you're willing 
to tlirow it aw'ay, ids almost always w'orth the investnient in time. 

TaceSpan and AppleScript provide a powerful and rich 
environment for rapid prototyping, FaceSpan interfaces cim be 
designed such that they are full Macintosh interfaces, llie tool 
provides a fast way to mock up interfaces, and tho.se interfaces 
can lx? quickly modified as tlie prototyjx evolves- In a similar 
manner AppleScript is a wonderful prototyping language. The 
syntax is like psuedtKXKle, so the resulting scTtpts act as 
dcKumentation when niovitig to C++ or Java. It supfxirts objeci- 
oriented programming, as \a ell as a hrige library' of osax building 
blocks and access to siTiptahle applications. These ttxils and this 
methixl arc valuable additions to any programmers Kxillxix, 
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and tap AppleScript^ 


Debugging 
and beyond 


aj 


Single-step, Debug handlers 
individually. Try out commands 
in the middle of debu^ng. Have control over all yom 
variables. Find and fix bugs on the fly! 


Superior 
vocabulary 
access .idsir 


Explore the vocabularies of 
scriptable applications and 
scripting additions. Ibint-and- 
click to assemble commands and build objea specs. 


m 


Dozens of 
goodies 


Let tons ot built-in tools help 
you put togthcr your scripts. 
Help yourself to gobs of dr^-and-drop and navigation 
shortcuts. Experiment with scripting coimnands. 


Centralize 
your data 


With ScriptBase" (included), 
store and retrieve values in a 
central place, and share values betwan scripts, Stub 
data from one appliation and pick it up with another. 


FaceSpan 

integration 


Edit your FaceSpan scripts in 
Scripter with a mousedick. And 
debug^^ntm, using all of Scripter’s debusing tools. 


MaeWeek 

t scripts/’ 

BUY ONUNB . 4 202 298 9595 

www.mainevent.com 18006I68320 
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ALTERNATIVE 

ENVIRONMENTS 


by Rich Morin 


MacPerliA Developer’s Overview 


The Power of Perl, the 
ease of Macintosh 


Om^RVIEW' 

Perl (and, by extension, MacPerl) is a 
convenient and powerful language for 
administrative programming, CGI scripting on 
the World Wide Web, data analysis and 
filtering (such as error checking and 
reformatting), network programming, and 
more. In short, Peii can be used for almost any 
programming project you may have in mind. 

On Undc systems, Perl is well on its 
way toward taking over all substantial 
scripting functions, supplanting traditional 
tools such as sh, awk, and sed. On 
Macintcjsh systems. Peri can be used just as 
readily (with the added attraction that 
there is nothing to unlearn*). 

Peri was LTcaied ten years ago when 
its author, Larry Wall, decided that existing 
scripting languages were insufficiently 
powerful for the distributed, bug reporting 
projea he was working on, Seeing the 
potential in his new tool^ l^rry was 
gracious enough to release Perl as 
freeware (freely redistributable software in 
source and binar)^ forms). 

Other programmers picked it up, tried 
it, liked what they saw, and suggested 
cnhancemcnLs and modifications. In a few 


years, Perl grew substantially in capabilities and in adherents, 
and was weil on its w^ay to becoming one of die mast powerful 
and popular computer languages in use today. Although Perl was 
originally written for the Unix operating system, it has since been 
ported to many different systems. 

Lbe recent rise in popularity of the World Wide Web has 
assured the popularity of Perl for some time to come. Perl is not a 
“strongly-hyped language’' like Java, but it has shown itself to be 
an indispensible tool for creating and maintaining Web sites. Perl 
is used for CGI scripting, site management, and many other duties. 

MacPerl (ported by Matthias Neeracher) has also been in 
existence for .several years, but its popularity has not increased at 
the same rate, and certainly not to the level 1 feel it deserves. The 
Macintosh is a friendly, easy to use, and very popular computer 
system. MacPerl is an elegant and friendly Macintosh adaptation 
of an extraordinarily powerful (and popular) programming 
language. Why hasn't it taken off as quickly as Perl has? 

Many potential MacPerl users am unaware that Perl (let 
alone a Macintosii version) exists! Most Macintosh magazines, 
rightly or wrongly, shy away from programming articles. Also, 
lacking any commercial reference material or distribution CD for 
.Mac:Perl, many prosjX'Clive users may have felt apprehensive 
about getting involved. PTFs MacPerl produti (anti articles like 
this one!) should resolve these issues, helping tJje community to 
grow substantially 


lANGUAGE Summary 

Perl syntax and Funclameatal capabilities are reminiscent of 
I hose found in C, Tiie following bit of ccxle, for instance, would 
work in either language: 

printf(*’hello, worldAn*^) : 


A 30-yeaT veteran of the computer industry. Rich Morin <fdm@pif,com> writer the J/Ojjener column for SunExpert magazine. 
His desktop system, Ced>enis, is a three-headed Power Mac, networked to several UNixish (FreeBSD, Mklinux, Rhapsody, 
Solaris, and SunOS) systems. 

Rich is also the president of Prime Time Freeware <http://www.ptf.coni/>, wliich publisher mixed-meilia (l>ook/CD-ROM) 
collections of freely redistributable software. RTF’s Mac-specific products include MacPerl: Power and Ha.se and MkLinux: 
Micmkemel linux for tJie Power Macintosh. Ihis article contains material adaptetl from PTP.s MacPerl book. 


30 


MacHuil: a Diivkloi'kk’s Ovkkvihw 


MacTech • February 1998 














Ignoring a few dollar signs (indicating that the keyword is 
being used to name a scalar variable), most Perl code looks quite 
a bit like C code: 

$cnt^SstJii*0: 

for tSi^Slo; $i<Shi: Si^J t 
if C$xy 2 i[$ll >- 0) t 
$cnt++: 

$sun ^ SxyztSiJ ] 

1 

1 

priiitf|“V$cnt^d* \Ssyin-\d\n**. Sent. Seum) : 

Perl adds syntax and capabilities from several other 
languages, however. Here are some Perl comrminds dial might 
be more fanitliar to an awk, sed, or shell scripter: 

$month ” SmanthB C n “ I; * hash (assodaim: ana>') 

Supper ^ tr/[s’z] / IA-7 j] / : « dmracter ^ibstituUoa 

Spath * regular expression 

$wd = "pwd^; ^ subpnKcss invocation 

Scf ile ® ** SbagE * c “ : * variable iotcrptilation 

print “hello* worid\n": unfijnnaned prim command 

In fact* die basic Perl language offers a wealth of features 
unmatched in any other popular piognimming language, indiiding: 

• anonymous fundJons, defined at run-time 

• arbitrary-Iengdi strings and data stnicmres 

• associative (possibly persistent) arrays (hashes) 

• automatic garbage collection 

• comfX)und data structures (such as queues of arrays) 

• dynamic storage allocation 

• file name globbing (wild card expansion) 

• late liinding of data and hincfions 

• lists: deque, queue, indexed array, stack, and more 

• coercion between numbers and strings 

• object-oriented features (such as inheritance) 

• regular expressions for matching and substiiution 

• run*time evaluation of arbitrar>^ code 

• nm-lime tracing and control of external data 

• sparse arrays (indexed and hashed) 

coie language is sypjjlemenLed t>y a wide variety of 
predefined objects. Some of these ate included in tlie Irase 
distribution; otliers can be found on the Comprehensive Peri 
Archive Network (CPAN), an iniemational set of FTP mirror sites. By 
ifxjking around a little, you can find objecLs for arl)itrary-prec:ision 
aritluTielic, CGI MTipting, genetic sequence manipulation, network 
administration... well, you get the idea. 

Perl's language features and object definitions work together 
in very powerfiil ways. A Ferl-ba,sed CGI script can, quite trivially 

• accept information from a user, checking it for validity 

• retrieve data from .selected files or a remote database 

• perform art>ilrafy, user-specified calculations on the data 

• generate a grafsli from die results, storing it as an image file 

• output Hl'ML to display the graph, wiili annotations 

What’s more* this entire operation can be performed in a 
demonstrably secure manner* using Perl’s mechanisms for data¬ 
flow' tracing, safe run-time evaluation of code, and more. 


MjVcintosh Ease of Use 

MacPerl can run as an application under die Finder or U5 a 
tool under MPW. Because most Mac users do not have MPW* the 
Finder version tends to dominate. I am told, however, that the 
MPW version aas much like any oilier MPW tend, supporting 
conunand-line options, ToolServer, etc. 

Hie MacPerl application normally operates as an interactive 
development environment, displaying edit and interaction 
windows. When a MacPerl document (script) is double-clicked, 
it will either start up an edil/debug session or a batch program* 
depending on a userKlefinable preference. It also i.s possible to 
create ‘'droplets”, MacPerl .scripts which support the Macintosh 
drag-and-drop protocol. 

MacPerl has a built-in text editor, liut it also works well with 
text editors such as Alpha and BBEdit. Both directly and liy 
meaas of an Apple Script interface. MacPerl programs can emit 
and receive Apple events. Because of its interpretive namre* 
MacPerl provides a pleasant way to interface with die T(k>IIx>x 
(prototyping Dialog Boxes and such). 

Although a Peri compiler Is under development, current Peri 
implementadons use a hybrid compiler-interpreter. Tlie Perl source 
code is syntax-checked and parsed, but noi turned into the hast 
system's machine language. This approach allows Perl scripts to start 
up quickly and still run at a reasonable speed. A Perl script typically 
mns within a faaor of three of the speed of a compiled C program. 

Lecml Issues 

MacPerl (like Perl) is free software; it may be used, 
modified, and redistributed under the terms of the Perl Artistic 
License. This license, crafted by Urry Wall, is quite flexible. It 
allows commercial and non-commercial distribution of the 
program* with fairly minor restriaions. See die license text 
(included with the distribution) for specific details. 

Please note that this definition of “free software" is far 
broader than that used by many Macintosh ‘‘freeware” 
applit:ations. Hie fact that MacPerl is available in source code 
allows any inieresied party to look over its construction and 
modify its liehaviot This has had a great deal to do with the 
grtiwth and overall robustness of MacPerl and Perl. 

PtlRTlNC; I.SSUFS 

Peri comes from tlie Unix community, which does some 
things rather differently than the Mac OS community. Where 
possible, MacPerl makes accomodations, providing “reasonable” 
behavior. In some cases, however, tJmx-derived code will have 
to iie tweaked before it can be used* Finally, some kinds of Perl 
appiicaiions are totally unsuited for use on a Macintosh* 

The Macintosh uses a carriage return (\015), rather than 
Unix's line feed (\012), to separate lines of text* MacPerl 
accom(xiate.s this by emitting a carriage return when a newline 
{\n) is sjxrcificd (requests for \015 are, however, taken literally)* 
Similarly, when reading line-oriented text, MacPerl expect*s a 
carriage return, rather than a line feed. 

As a result, MacPerl does not accept line feeds as 
delimiters in its input program.s or data files. If you want to use 
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it UNFX-denveci 1’cirl siTipi or textual data file under MaePerl, 
you must first convert all of iis carriage returns to newlines, 
Tliis LS trivial, if slightly annoying. 

File naming syntax miLsr ab) be convertecL Slashes (/) must lx* 
duingcxJ into colons (:), full jyaili names must lx incxlified lo include 
disk names, etc. In addition, if the Unix code depends on "speciar 
flies (/dev/*, /procf\ and such), s<.^me modifications will be needed. 

Unix supports [preemptive tnulLilasking, allowing (nay, 
encouraging) programmers to invoke sepamte programs 
whenever this .seems appropriate. Perl follows in this pattern, 
giving programmers many ways (backquotes, cxcc, fork, pipes, 
and such) to start up other processes. 

MacPerl makes a few accomodations to multitasking. Certain 
backquoted commands (such as 'pwd') are silently emulated, 
handling common Unix idioms. Some multitasking may be 
perfomieci if IbolServer is present. (Of course, the requested 
program also mu.st bt? available!) Ccxle which depends Ktf?)ngly 
on mullilasking may ntPt [K)rt smtx^tlsly, however, even willi tite 
aid of the ToolNerver. If you find such a Perl script, you should 
expect to rework it cfuite a bit btdore you atn use it on a Mac* 
Some tJNix-dcrived Perl .scripLs will not fxprt readily. Code 
which depends on multi-tasking may not pon smoothly, even 
with the aid of 'roolServer. Code that depends on UNix-specific 
s 7 stem calls must be mcxlified or eliminattfd. 

Finally, sotne Perl scripts rely on binary cxlensioas 
which are linked into the Perl interpreter at am lime. Only 
a few of these extensions have been potted to MacPerl, so 
these scripls arc unlikely to work without a lot of efforl (and 
Perl-specific knowledge), 

MacPfrl Resoitrces 

The MacPerl Pages <http://www.ptf.corn/macperl/> are a 
centralized source of inforntation on MacPerl* They contain 
information on MacPerl, links to online resources, forms for 
joining the MacPerl mailing lisl and submiuing materials (such as 
code s;imples and war stories), and more. 

All mcxlesty aside, the definitive work on MacPerl Ls 
“MaePerh Pfjwer and Ease" (Prime Time Freeware, 199)1, ISBN 1 
881957-32-2, $40 MSRi^). Tliis product combines a 350+ page 
introduetc^ry and reference manual with a MacPerl disirihution 
CD-KOM, For more information, visit the Prime Time Freeware 
web site <http://www.ptf,com/>. 

Perl is served by two main web sites: <htlp://www.perl.com> and 
http://www.perl.org>. Try these sites before doing any sort of search: 
if you can’t find what you want through t>ne or the other t>r these 
sites, it [)robably doesn’t exist on die Internet, Though dierc are 
quite a few Ixioks in print on Perl and related subjects, the diree 
clefinitive b<K)ks are publi.shed by O’Reilly & AsstKiiates: 

• hfarnin^ Perl, Second Edilk>n, by Randal L Scliwartz, Tom 
Chiisiiansen, 1996, ISBN 1-56592-284-0* 

• Progmmminfi FeH, Second Fklition, by Urry Wall, et al, 1996, 
ISBN I 56592-1194. 

• Adt^anced Peri Pjr^ramming by Sriram Srinivasiin, 1997, 
ISBN 1-56592-220-4, B 


Don’t settle 
for less than 
Everything! 

Objective-Everything"' 

■ A MUST-HAVE tool for Rhapsody 1 

■ The preeminent scripting solution for 
Yellow Box. 

■ Rapid prototyping and exploratory 
programming as you have never seen it 
before! 

■ True language independence - use the 
best programming language for the task 
at hand, or even mix-and-match 
languages! 

■ Use Python, Tcl, Perl, and Objective-C. 

Objective-Browser'^ 

■ View objects In a running program. 

■ Investigate program structure and object 
inter-relations. 

■ Class hierarchy, methods, instance 
variables, and other object information 
can be viewed and edited during program 
execution. 

■ Customizable and extensible. 

TipTop Software, Inc. 

PO Box 3068] 

Bethesda MD 20824 / USA 
301-656-3837. 301-656-8432 fax 

tiptop@tiptop,com 
www*tiptop.cofn 
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TOOLBOX 

TECHNIQUES 


Steve Sheets 


Contextual Menu Modules 


By creating Contextual 
Metm Extension Modules 
for Mac OS you can 
extend the behavior of all 
applications 


A Nkw type of Extension 

The Contextual Menu (CM) Manager 
was introduced with Mac OS 8-0. Using 
this manager, developers now can provide 
contextual menus in thetr programs. When 
a user clicks some data while holding die 
control key down, a list of data specific 
commands can appear. For example, the 
Finder uses this API to display various 
commands (Open, Move to Trash, Get 
Info, Duplicate) when files & folders are 
control-clicked. As mentioned in last 
month's article, the commands dial are 
listed come from two sources; the prognim 
and CM extension modules, 'Itiis month's 
article will demonstrate how U) eremite the 
example plug-in “CaseChann". 

At any point in a program that uses 
the CM API where ^Contextual MenuSe I eel" 
is called, the piograrniner can provide 2 
im[iortant pieces of infonnation. First, he 
can provide the list of the commands to Ix" 
displayed. Secondly, he can provide the 
data that Is currently selected, CM 


extensions, also known as plug-ins, can use this data to decide 
what additional commands also can lx? added to die menu. If the 
user setecLs one of tlie commands that comes from the plug-in 
instead of from the program, the plug-in takes care of that aaion. 
dlie calling program is not aware that anything was selected; it 
just functions as if die user failed to select an item from the 
menu. Except for being able to look at the selected data, the 
plug-ins are transparent to the calling program, and the calling 
program is not awrare of the piugdns. 

So what are CM extensions? Tliey are PowerPC code 
fragments (tliat is, shared libraries) using the SOM Object model. 
Because of this, plug-ins can only nin on PowerPC Macintoshes. 
Ihe API is standard on Mac OS 8.0 computers, but it also can be 
installed on 4Systcm 7.X machines. Do not assume that all the Mac 
05 8,0 APIs are available for a contextual menu. Though 
uncommon, contextual menus can lx used on a pre-8,0 machine. 

CM plug-in files must have the file type of ‘empp. If they 
have the cTcator of 'emnu', they will display the generic CM icon. 
The extension file must reside in the “Contextual Menu Hems’' 
folder in the System Folder, On Mac: OS 8.0, dragging the 
extension onto the System Folder will automatically move the file 
to the correct location. On pre-Mac OS 8.0, you must drag the 
files manually. Once they are in the correa kxtation, die System 
must be rebooted for the plug-in to lx installed. 

Being SOM objects, CM plug-ins are object-oriented 
subclasses of the super class AhstraciCMPIugin. 
AbstractCMPlugin object has several calls tliat must be 
overridden for the extension Lo work. While you can create CM 
l>lug“ins that do not look at the selected data, but just provide 
some function, this is not a recommended. There are plenty of 
other way to provide commands in the Macintosh. Apple 
recommends that third party developers work on CM plug-ins 
that are data sensitive. 


Steve Sheets has been happily progranmiing die Macintush since 1983, which makes him older than he wishes, but not as 
young as he acts. Being a native Californian, his developer wanderings have led him to Nortliem Virginia. For those 
intere.sTecl, his nori-t:oniputer intere.st.s involve lus Family (wife ik 2 daughters). Society for Creative Anachronism (Medieval 
Hcxmacimcnt) and Martial Arts (Fencing, Tal Chi), He is currently an independent developer, taking on any and all projects 
and can be reached at <MageS!eve@AOL,CDm>, 
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While the Contextual Menu Manaj^er passes the selected 
data to the plu^-in^ the plug-in can not mtxlify diis data. At most, 
it can make a copy of the data, modify the copy, and then return 
the data l^y placing it in the Cliplxjard. The example project 
CaseCbarm, discussed below, takes text data and shifts it to 
cither upper or lower case. For example, in a word processor, a 
user would select a word, control-click that word, select the 
CaseCharm command, then paste the content of die Cliplxiard 
(the word all in upf>er or lower case) back into the word 
processor This passing of modified data using the Clipboard is a 
common function of CM plugdns. 

Creating a Module Project 

while a CM project can be created from scratch, the easiest 
way to set up one is to take an existing CM sample project and 
modify it for your needs. It is to easy to incorrectly set one of the 
required preferences in the project. In the CM Manager SDK 
(available from Developer CDs and websites), Apple provides a 
good sample program to start with. The example used in this 
article is based on Apple's sample code. 

You must change a couple of project preferences when 
creating a new CM plug-in. For this project you must first change 
the FPC Target file name to ''CaseCharmT Next, the PPG Linker 
Entry Point for Initialisation must be changed to a new' name. 
While it can be anylliing, the common usage is XXXInitiaiize, XXX 
is the name of the CM plug-in, in this case ^^CaseCharmlnitialize". 

Then you must modify the source files to match the name 
changes. The x:p, .h & .r Files should be renamed to match die 
CM plug-in name. In this case, “CaseCharm.h", CaseCharm.qj'' 
and "CaseCharm.r”. Following sections will explain the 
changes within these files. In addition Lo these source files, the 
sample project includes the '"LlContextualMenuTools.cp” fOe. 
This code provides many useful routines to handle functions 
common to all CM plug-ins. 

Additionally, various libraries must be linked in the projea. 
The,se include AbstractCMPIugin, InterfaceLib, MSL RuntimePPC.Lib 
and SOMObjects^” for Mac OS. The file names for some of these 
libraries may be different for different developmenl 
envirtmmenls. The AppearanceUb library is required only if the 
CM plug-in uses the Appearance Manager. 

Once all the changes are done, compile and link the code. 
As mentioned al’Kive, the resulting shared library must ixi 
dnigged to the "Contextual Menu Items" folder and the Mac 
rebooted to test the code. 

Adding RESouKtiis 

A CM plug-in does not require much in the area of 
resources. Like all code fragments, the 'efrg' resource is recjuired- 
The fields containing tlic code fragment name 8c help 
information (in this case the strings ‘^CaseCliarm" and “A 
Contextual Menu Plugin to change the c-ase of selected texC) 
should be changed. It is always a good idea to include version 
information (‘vers' resources) with any code. 


Usting 1_ 

CasceturniT 

Typical rcsoances (br a Qintextml Menu plug-in, in ihh ca«e CaseCharm. 

^define LseExtendedCFRGTetcplate 1 

#iticlud€ "SysTypes.r’* 

jf/inc iude “ CodeFragmentTypes. r " 

r C<)de Fragment Info 7 

resource ’efrg' (0) [ 

{ /* afpi>' mcmb<rrArra>” i dements V 
extendedKntry ( 
kFowerPC, 
kFuIlLib, 
kKoVersionJfum, 
kHoVersianNum, 
kDef aultStack,Sise * 
kNoAppSubFolder» 
klsLib, 
kOiiDiskFlaL, 
kZerqOffset, 
kSegIDZero, 

Ca s eCh a rm " , /* CImtged tbr each Plug-iu 7 

kFragSOMGlassLibrary. 

‘‘.AbstractCKPlugln*', 

"A ConLexLual Menu Plugin to change the ease of " 
“selected text," /* Changed for each Plug-In 7 
I 

] 

f: 

/* Version info 7 

resourca ‘vers’ (1) t 

0* final* 0* verUS. “1.0", "Mageware* 1997" 


resource 'vers' (2) I 

1, 0* final* 0* verUS* “KO"* “CaseCharro 1*0" 


Methods and Methods 

As will be Slated over and over, a CM plug-in is a SOM 
object. In this example, CaseCharm is a subclass of class 
AbstractCMPIugin, This new class overrides 4 methods of 
AbstractCMPIugin. CaseCharm also requires one special 
initialization routine for SOM to identify it. All CM plug-ins 
override these 4 methexis (and provide an Initialization rouime), 
so the header code is generally identical Listing 2 shows the 
CaseCharm, h file. '1‘he name of the new subclass of 
AbstractCMPIugin must match the name given in the resource file 
(in tills case, ‘'CascCliarm"). 


Li5tmg2 _ 

CaseCharm. h 

Typicijl licada- file for a Conicxlual Menu plug-in. in this ease CaseCharm. 
ifpragma once 

if) on! Lidfi <Al>stractCMPlugin,h> 

class CaseCharm : virtual AbetractCMPliigin i 

^pragma SOHReieaseOrder (initialiai^, KxamineContext, 
HandleSelection* PostHenuCleanup) 

public: 

virtual OSStaTus TnitlalizelFnviromnent* ev. 

FSSpcc *iiiFileSpee) : 
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virtual OSStatus ExamineContext(Enviromuent* ev* 

AEBesc ‘inContextDescriptor♦ 

Sint32 inTimeOutlnTicks. 

AEDescLi st* loConiniands. 

Bcale-an* DUtNeedMoreTjine): 

virtual OSStatus llandl«Selection{Enviror]jnent* ev. 

AEDesc ^InContaKtDeacriptor:, 

Sint3 2 inComniandlD); 

virtual OSStatus PoistMenuCleanup(Environment* ev): 

]: 

The four niciliods shown here are called by the CM API 
when needed. Initialize^ handles the initialization of the current 
CM. This is different from the SOM Initialization routine (defined 
below). It LS easy to confuse die two calls. When die CM Manager 
is started up with the computer, a single instance of all CM 
extension objects is created. At that lime, rhe lnitialize{) call is 
made. This may l>e lx:forc odicr Managers have started, so 
generally nothing is done in this routine. The other 3 routines are 
all called when a contextual menu is being created for display. 
Tlie ExamineContextO method is where the plug-in adds menu 
items to llie popup menu. This is the first time the code can 
examine the selected data (if any). Based on the data, the 
method can put any number of menu items or sub menus into 
die ciirreni coniextual menu. The HandleSelectionO call is only 
called if a given menu item has been selected by the user It can 
then handle the actual function seleaed. 'Ihe PostMenuCleanUpO 
call is the routine to be called alter tfie current contextual menu 
has iieen handled, regardless to who handled it. The first 
parameter for all four of the routines is a code fragment 
environment parameter and isS mrely used, 

SOM FrAGMENJ IlSIlTALlZlMG 

Being a SOM object, CaseCharm is required to have an 
initialization routine. J'he name of this routine can be anything, 
bui ii must match the name entered in the Linker preferences 
(CaseCharmlnitialize in diis case). Listing 3 shows die section of 
the code dciding with tliis call. ^Ihe function calls the SOM 

_initialized routine, and defines the new clas.s. Except for the 

name, there is no reason to modify this code. 

Listin g 3_ _ 

CaseCharm .cp 

iragmcni Initializer 
// Includes 

fllticlndfi (CodePtHgiretitK.h> 

#inciijdc Csom,xh> 

U External Functions 

extern pascal OSErr _initialize(CFraglnitBlockPtr); 

a Initiali/LT 

pascal OSErr CaseChatiDinitiaiize(CFragInitBlockPtr init) 

I 

/^pragniH unused [iniL] 

OSErr theError - _inltlalize(inlt): 

if [theErresr = noErr) 
somNevClassiCaseChartn) i 

return theErret; 

1 


Setup and Shutdown 

The InitializeO routine is called at startup of the current 
instance of a contextual menu, and is surprisingly useless. 
Memory and resources should be allocated when the contextual 
menu is being used and not kept around all the times. The 
PoslMenuCfeanUpO call can take care of anydiing started hy 
ExamineContextO, Kemember the HandleSeiection() method may 
not be called Lf the user didn't select an items. It is more 
common, as in the Ca.seCharm example, for them to do nothing 
but return a noHrr result. 

listin g 4_ 

(^iiiieChann.cp 

Setup Sl Shutdown 
// CMJniiulizc 

OSStatus CaseCharm:rInitialize(EnviromnEnt* ev , 

FSSpec* inFileSpec) 

I 

ilfpragHia urui.^ed (ev, inFileSpec) 
return noErt; 


// CM Clean Up 

OSStatus CasaChartn::PostMenuCleanup(Environment* ev) 
I 

ffpragma unused (ev) 

return noErr; 

I 


Coercing Text Data 

Both the ExamineContextO and the HandleSeiection() call are 
passed inContextDescriptor, a pthnter lo an AEDesc. This 
descriptor contains the selected data that the user control-clicked. 
This CM extension can use this descriptor to examine the 
selected data, UContextualMenuTools has a few routines that 
provide commonly used rec]uesls. Listing 5 show 
G_GontextualMenuTools_Has_Text_OataO (which checks if text 
data has been passed), G_ContextualMenuToQls_GeLTexLHdl() 
(which returns a copy of text pas.sed as handle) and 
G_ContextyalMenuTools_Get_Text_Str(} (which returns a copy of 
text passed as string). 

Since AECoerceDesc is being used, the Apple Event 
Manager tries very hard to return text ditla, even if the original 
data was not exactly text. For exam|Dle, control-clicking a file 
from the finder would pass a file reference. However, 
AECcx^TceDesc would successfully conven the name of the file 
into text, and return tliat text. This is not dangerous, just 
something that should be noted, 

tistin gj__ 

tlConiextml MenuToob. cp 

HundliugTcxt Data 

// DeycripiOT ha.'j tcxi data stured in it 
Boo lean G_C0at oxt ua 1 HoiniiToo 1 S_Has_Te3ct_Da t a 
(AEDesc* p context descriptor_ptr) 

I 

Boolean a_fTag ” faT'je; 

AEDesc a_text_desc = I typefiull* NULL I; 
if (AECoerceDesc£p_context_descriptor_ptr. typeChar. 
&a_text_desc) “ noEtr) 
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1 f (ex esc. desc r iptarXype^typeChar ) 

if (fl_ieKt_<Jc'SC*datflHandle) t 

long a_si£e = GetHani31eSize{a text_desc.dataHandle); 

a flag = ta_si 2 e> 0 ): 

1 

AKDispuei^Doac (&a. taxt dasc): 
return a_flag; 

\ 

// GerText Duiii fn>m ikstripior iii liajidU: 

Ha nd 1 e G_C<? n t extua 1 HenuTo o 1 s_G e t_Te1 

(AKDase* p cont6Xt_descriptor_ptr) 
f 

AEOesc a^text^desc "■ i r.ypeNull* NULL 1; 
if CA^CoerceDeec {p_t'ontoxt_descrtptor ptr. typeChar* 
&a_teKt_clescJ ^ noKrr} 
if (a i:ejit_deso*descriptorType=iypeChar) 
return a text^deec.dataHandie: 

AKUiapoa{!llo^c(&a„text desc); 

return NULL; 

I 

// Get Text l>ao fa>m dc!>4:ripcor as string 

void G_CofitaxtualHenQTool3_Get_Text_Str 

(AEDesc* p context_d€£criptor_ptr, Str25^ p_str) 

I 

p.strLOj = 

Handle a_handie =* 

G_CDTitex±ualMenuTools_Get_Text_Hdl (p_ccmLext_iiescr I ptor pt r): 
if (a handle) { 

HI-ock(a_handle) ; 

short a_lari ^ GotHandleSize(a.handle); 
if (a_len>2bi) 
a_len = 255; 

BlockMoveC*a_handle* &p_str(l] , a_lerj); 
p_str[0] “ a len: 

HLlnlo(;K(a_haridle): 

DispoaeHandlet a^andl e): 

) 

I 


Adding Mmus & Submenus 

Once the CM plug-in has identified thai it was piis,sed data 
that it can use, the code must add items and submenus to the 
contextual menu Iwing created. Not surprisingly, the CM 
Manager uses ioCoinmands (an ABDesc) to do this. Kat:h menu 
item requires a string and a ID number. The ID number is 
strictly unique For this CM plug-in. The CM Manager keeps track 
of ID between different plug-ins. Assuming the user selects <jne 
of the items this CM plug-in created, the HandleSeleciion() call 
will be passed that ID. 

Listing 6 shows a number of routines that are useful for 
creating these menu items, including a routine to create a 
menu item: G_ContextyalMenyTools_Add_Menultem(), a routine 
to create a blank (dotted) menu item: 
G_ContextualMenyTools_Add_Blank_Menultem(), a routine to 
Stan a sub menu: G_ContextualMenuTools_Slart. SubMenu() 
and a routine to finish creating a sub menu: 
G_ContextualMenuToolS_Finish_SubMenu(). 
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Listing 6 _ 

I f(;ontcxtuaIMcnuTot>is.q> 

Huildinj; Mcou^ 

// Adil Menu Item to AEDcscIiit 

OSS t a t us G_Co n text im iMenuToo 1 s_Add„Menu 11 eni 
tSrr255 p name, long p_COffl[mand. 

AEDesct.ist* p comiiand_list,ptr) 

I 

OSStatus a_err “ noErr; 

AEReootd a. tosuBand_record " I typeNul1» NULL ]; 
s_crr * AKCreateList(NULL. 0. true, fra^conmand^record); 

if (a_arr^noErr) \ 

a_err = AEPuLKeyPtrt&a.comniatid record. keyAENaine. 
typeChar* ip_nataefll* p namefOl); 

If (a err^^oErr) 

a. err = AEPutKeyPtr (6ia_coiniiiarid_rtfcyrd. 

keyCoataxiualMenuCommandlD. typeLonglnteger. 
Ap coiETDand. sizeot (p^conmiand)); 

if ta_err”iioErr) 
a_err = AEPutUeac 

{p_cc!]!inaami_ll 3 l_ptr. 0. coBunand record); 
AEDisposcUese (i^a_co6iiinand_tecord); 

1 


return a_err: 
I 


// AUd lU^mk Mcau ttem 

OSStatus G_(k>ntextualHenuTools_Add^Rlsnk Menultem 
(AEDescList* p^comnand.Hst ptr) 


I 


return G_ContextualMenuTooIs_Add_Menulien 
P"A p -" . 0. p_c oramand„Ilst_pt r): 


// Sun nuking a SubMcnu 

OSStatus G^ContextuaiMenuTools Start SubMenu 
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(A£De sc L i 81 * p_8 u bmenu^c oiEiaand_l i st _ pt r) 

p_Submenu_COBimand_llEt_ptr-)dGBcriptorType ” typeNull; 
p_subnienii_coni[aand_list ptr->dataHsTtd1e * MiniL; 

return AECreateMst 

{NULL* 0, false, p_subaienii_coiflffland_lifit_ptch 


// rioi&li ninking a SubMcnu 

OSStatus G_Contextua 1 KenuTools .Finish. SubHenu 
{AEDescList * p_cQTiiiiand_i i st_pt r * 

AEDescLi st* p_submetiii_coiHiiiand_llst_pti:. 
stress p_supernienu_iianie) 

I 

OSStatua a_err - noErr: 

AKRecord p_3upeniienu_coJnmflnd_li8t = \ typeNuIl, NULL h 

a_err - AECreataList 

(NUU-* 0, true, itp_8upertiieEiu_cciiLinaTid_liat): 

If {a_ert"lioErr] 

a_err * AEPutReyPtr (£ip_superjnenii„coEuiiand_li3t, keyAEName, 
typeCh a r, S p_s up e rmen u _ nm& [ 11, 
p^flupermenu naaefOl): 

if (a_err“noErr) 

a^err - AKPut,KeyOeSJc(&p_superiaenu„cororoand„iist, 
keyConlextualHenuSubmenu. 
p_aubiiienu_command_list_ptc]; 

if {a„err=iioErr) 

a_err " AEPutDesc{p_cotnmand_I ifit_ptr» 0* 
ip supermenu„coEnraand_list) i 

AED i 8 p os oUo s c ( p_s ubBffi riu_c oiiiiiand_i 1 s t _pt r): 

AEDlspoaeDesc {&p_superraenu_coimiiand_list): 

return a_arr: 

I 

Tilt add munii iieiti ftinciioo \s p^Lssed the name of tlic menu 
item, the ID, and ilic AEI3csc Uj attiich the item to. It createss a 
lemponry list descriptor, adds tlie data to it, and [>uLs ilie lust into ilie 
[xussed AEDesc. The temporary list is then disposed of. Tile function 
G,ContextualMenuTools_Add_Blank_Menultem() calls the function 
G_C>xitextualMenuTools„AcW^Memite witli tlie ainetl values to 
create such a blank menu item* When the ioCoirumnds fxiraineter is 
used will! tlKise routines, the menu item is put on the tof>mc^t 
menu, lloweva- these routines aiso can Ix.^ used on submenus* 

To create a submenu, the call 
G_ContextualMenuTools_Start_SubMenu() to create an AHDesc. 
Use this descriptor just as if it was the ioCommands parameter 
and add menu items to it. When all the menu items are added, 
used G_ContextualMenuTools_Finish_SybMenuO to attach the 
submenu (with name) to tlie ioCommands. In this manner* you 
can create any number of submenus. Listing 7 shows liow to 
do itiis in the CaseCharm code. A submenu is created. 
Assuming text is available, two commands (and a blank line) 
are added* No matter what, the About command is added* and 
the entire submenu is then added ro the main menu. 

The only otlier two yei to be explained parameters for 
ExamineContext are inTimeOutlnTicks and outNeedMorelime. The 
inTrmeOulInTicks v-aliie is the amount of time the CM plug-in can 
use to examine the selected data. If the call takes longer than 
this, it should return, with the outNeedMoreTime parameter ser to 
true. This allows the CM Manager to handle creating larger or 
more difficult menu items* For simple contextual menus that do 
not access the disk (like the example), it is safe lo set 
OutNeedMoreTime to false. 


Iistiiig_7___ 

Casct^jann.tp 

CAt Exaime CoutCDT 

OS S t atus Ca s eChs urni ;ExamlneContex t(E d vir onment • ev, 

AEDesc “ iaContext Descriptor. 

SInt32 inTitHROutlnTlclts, 

AEDesrXlst* 1oCommaodSt 
Boolean* outNeedMoreTime) 

I 

if pragma unused lev, inTitteGutlnTicks) 

if (InContextDescriptor I- NULL) I 

AEDescList a_sub..iiienu commands * I typcNull* NULL ]; 

G ConTexTual KenuTool 8_Sli*rt_SubHenu (4(a_sub_meiiu_coiimiands); 

if (G_Go tit ext ualMe nut o 0 1 s_Ha s^Text^D a t a 
(inContextDescriptor)) 
f 

G_ContextualMenuTooIs_Add_McnuItem 
(“\pConvert to Uppercase"** 1002, 

Aa ub_iiie nu„c oratna ri d s 3 : 

G_CoiitextualNenuToai e_Add_MenuI tem 
(“ApConvert to Lowercase'', 1003* 

&3_sub_menu_coiEinands); 

G Con t e 3C t us 1 He ntiToo 1 s_Ad d_B 1 a nk_Hen u 11 c m 
(£ra _sub_iBonu_communds) ^ 

1 

G_C on c e X t ua1Hen uTo o1s_Add_HenuItem 

("\pAbout CaseCharnL,"* lODl* ka «ub menu^commands)i 

G, ContextualMettuTool nisb_SubHeriu 

(loCnmnand s, ^ra_sul>_Mienu_eoinmand s * “ \ pCaseCharin”): 

1 

* outNeedMoreTime false: 
return noErr: 

1 

More and more CM plug-ins are curfently being created* The 
room on the contextual menus is starting to nm out* tf the CM 
plug-in you create as more than one or two coiumands* I suggest 
putting the entire list of commands into a submenu. This is 
Ix^coming a common user interface; a submenu with the name 
of the product* a numlier of command tnenu items, a blank line* 
and the About command menu item(s)* 

OLJTPurnNG Rlsuli hirodgi] the Sc:rap 
When a user selects a given menu item in tlie contextual menu, 
ilie ID Ls passed to the assrx'iated CM plug-in. Again, die selected 
data an be parsed out. Assuming .some rnanipuiation i.s done on it, 
the result can be passed back to die user in die Clipboard (diat is die 
Scrap). Listing 8 sfiows some simple routines to reairn text (as 
handles or strings) to die user tliis way. Notice that 
G„ContextualMenuTools_Set_Scrap_Text. Hdl() does not dispose of die 
luindle, so tlie prcjgram miLsT do it explicidy after die routine is called. 

Listing 8 _ 

UCtmtcxnjalMeDuToob.cp 

Set OipbejaiU Tcxi 

// Set Text Scrap using handle 

void G_Contextua 1 MenuToo 1 s_Se L_ScrapjfextjidI 
(Handle p_handle) 

I 

ZeroScrapO ; 

if {p_handle) \ 
iILock(p„bandie): 
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FutSci:apEGetfiaiidleSize(p_handIe)» ’TEXT\ *p_handle); 
HUnlock(p_handle): 

I 

J 


// Sci Text Setup using str 

void GjContextualMeiiaTGolfi_Set:_Scrap_Text_Str(Str255 p_etr) 
1 

ZeroSerapO i 
if (p strfOl) i 

PutSerap(p_strfOK 'TEXT'. &p_strlll5: 

1 


USFJR Ijnterfacf 

Contextual menus can have user interfaces. If a user has 
selected an iiem, diaioj^s and alerts can be displayed. *lhey 
have to be modal, and be cleaned up before the 
HandleSelectfonO routine returns. Ustmg 9 provides some tools 
for this. The function G_ConlextualMenuTools_Standarcl_Alert() 
crealcs a standard information alert using the new Appearance 
Manager StandardAlert() call. Since the CM Manager may run 
on machine without the Appearance Manager, it uses the 
G_ContextualMenuTools_Get Gesta!t_F}ag() to make sure the 
call is available. 

More complex ttser inierfaces can Ik? treated using 
resource.s stored in ilie CM plugdn file. However, this file is not 
open as a resource file when the code is called. The 
G_ContextualMenuTools_Open_ResfileO takes care of this. It uses 
FindFolderO to .search for the Contextual Menu Folder. If that fails, 
it scarclies for the folder by name. (In pre-Mac OS 8 computers, 
the CM Installer appears to tail to set the Contextual Menu Folder 
to the correct ID.) Once the file is open, any ty|x? of resource can 
be accc.s.scd from it. Just remember to close the resource file 
when you are done. 


User Intcrfecc^ 


UContcxl ualMeiiu rooJs.q> 


// Omk Uil flag of Cjcstalt sdcctor 

Boolean G_Contextuall!enuTools_Uet_Gestal t_Fl ag 
COSType p_eelector. short 

( 

long a_result; 

if {Gestalt(p_selector* ts_result) = noErrJ 
cetum BitTst{&a_resul C, 31; 
else 

return 0; 


E gestaltFSAtt r, gestal tllasFSSpecCalls) 

&k G_Coai;extua IHenuToo 1 t_Cestall„tTag 

EgestaltFindFolderAttr. gestaltFindFolderFrescnL)) [ 
long a dir_id: 
short a_vol_tef hum; 

FSSpec a_filc_npec: 

if EFlndFoldGrEkOnSygtcmDfsk. '(^tnnu'. kCreatoFoldet. 
&a_vol_rGf_nutn. ka^dir^id) “ noErr) [ 
BlockKove(Sp_npiiie [0]. ba_fiie_spec.nGtnG [0], 64); 
a_file„spec.vRefNuni ^ a_vol_ref_nuiii: 
a file_spec.pert& ^ a_dir_id; 

a_resu11 = FSp0penResFlle(6a flle_spec. fsRdFem); 

I 

else if {findFolderEltOnSysteronisk, kSysteniFolderType, 
kCreateFoider, £ia_vol_rer_niJHi. &ii_dlr_ld) 

= noErr) I 

Str 2 55 a_dir_naine “ "*\p: Contextual Menu Items;''; 
short a dir namOen “ a_dir_naii!e[0l : 
short a^name len p namefO]: 

BlockHoveC&p^nadcEl]. iia_d I r_[iainf! [s dir name lenhlj, 
a_tiaaie_lenj; 

a_dir_nameiO| ^ a_dlr„iiatw_len + a_nam(^_lon: 

a err = FSKakeFSSpec (a_voi_ref_ni«i. a_dir_id. 

a dir.name. ta,file_flpec): 
if (a_i?rr“^noErr) 

E_resiLilL FSpOpenResFi 1 g[£ ia file spec, fsRdFerm); 



retnrit a result; 

1 


SAMPI.E Code 

Itie finuf li.sLing, Listing 10, shows the HandleSelectionO code 
for tlie example, CaseChami. Depending on the command passed 
ill inCommandID, it shows the About Box using tfic 
G_ContextualMenuTools_Standard_.Alerl() call, or it retrieves the text 
using the G_ContextualMenuTools_Get Text Hdl() call and passes it 
to die CaseChamnUpperLowerO- That routine shifr.s the cuse, and 
returns it using G_C€ntextualMenuTools_Set_Scrap_Text_HdlO. 

Listing 10 _ _ 

UComoctiialMcnutools-cp 

Handle Selection 

// Convert the given rexi (upper i>f lower) 

// and pUcc it in scrap book. 

void CaseCharmUpperLower(Handle 
Boolean p_is_upper) 

I 

if (p,text) I 

long a_lf!ngth = Gc!T.HandlGSlze(p_text) : 
if (a_lGngth>0) t 
lILock{p_texL); 


// Standard Alert 

void G^ContextualMenuToola Standard_Alert 
CStr255 p^tltle. Str255 p info) 

I 

if (G^GtJiitextiialltenLiTfJols_Get;_Ge3talt_FlaB 

CgestaltFSAttr, gestaltHasFSSpecCalls)) I 
short a_hit; 

StandardAlert(kAlertNoteAiert, p^title, 
p_info. NULL. 6a_hit): 
t 


// Open ContartualMcnu Resource File 

short C^ContextualFtenuTools^Open^ReEf tle(Str255 p name) 
I 

short a_resuit “ -Ir 
OSErr a_ert: 

if (p^nameDD I 

if (G_CDntextuaiMenuToo1S_Get_Gestalt_Fla g 


char a_char; 

for (long account ” E3; a_count<a_length; a_countlH^) I 
a_cliar = * (‘p_text+a_count); 

if (p.la_upper) I 

If ((a_char>-='a') {a_char<*'z*)) 

‘ ('p_leKT+a_enimt) a^char - ‘a' + *A*: 

\ 

else { 

if ({a_char>-'A') 6^ Ea_char<^'Z')) 

* [*p_text+a^count} = a_char 'A' 1 Va'; 

] 

1 

HUn1ock(p_te3Ct); 

C_CouLexLualMenuTools_Set_Serap Text_Hdl(p_text): 

I 

) 
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ALTERNATIVE 

ENVIRONMENTS 


Bruce O’Neel, LaurelMD 


An FTP Fetch CUent in Tcl/Tk 


A light introduction to this 
powerful, multi-platform 
scripting language 


OVKRVIFW 

Tcl/Tk (pronounced '‘tickle tee-kay”) 
is a scripting language written by Dr. John 
Oustcihout while he wa.s a prot'essof at 
the University of California ai Berkeley, 
'll! can either be a standalone shell where 
you issue commands (like those of tinix or 
the Ml^W sliell), or it can be a library 
which you enit>ed into your compiled 
program and use to issue commands. Tk is 
an extension to Tel which provides 
graphical interface Tcl commands 
enabling you to write event driven 
programs with graphol interhices. 

Tci^k has l>een very pripiilar in the 
Unix world for a long time and has recently 
l>een ported to Mac OS and Win93/Nl'. As 
c;f version 8.0 of Tcl/Tk^ the Mac: OS and 
Win9S/NT poits have a native look and 
feel on their respeaive platforms. This 
article is going to provide a brief overview' 
of Tcl/Tk and then present a 
demonstnition fcl/'llc program to fetch 
RIes using FTP, 

Tci/Tk Ovf.rvtfw 

Why is Tcl/llc kitere^ringl^ First, it is a 
dynamic scripting language. At run-time 
your scripts are byte compiled and run. You 
c'an get the names of procedures and 


variables at run-time; you am tleRne new commancLs and new 
control statements at run-timc; you can load new source ccxle at 
nm-time; and you can extend IcI with your own shared libraries at 
nin-time. Second, you can pnxluc’e Mac like interfaces using tlie 
native port of Tk and you can do (liis ciuickly and imerac rively. 
Ibink of it as rapid prototyping for die Mac in a free language. 
T'hirci, you can write scripts wliich can l>e moved unchanged from 
Mac OS to Win95/NT and most unix variants. Finally, you c:an easily 
write extensions to Tcl in any compiled language on die Mac, and 
they' can either call and lie callecl by C or produce sliared liliraries, 
Tliese exten.sions also c^m he CToss-pIatfonn if written to lie 
portable. As an example, a g!X)up of people at NASA^s Goddard 
.Space Flight Centei' have written an extension to Tcl wliich reads 
and writes a file format called used in astronomy 

<ftp://legacy.gsfc.nasa.gov/sQftware/ftools/release/other/fitstdmaosrcsEt.hqx>. 

There arc a few notes on TcFs syntax that will make 
reading the code easier. I'irst, remember that Tcl works by 
.suing substitution and that, from your point of view, 
everything is a siring. Svarname means look up the value rhai 
is currently assigned to a variable and put that string in place 
of $varname. [command arg arg] means execute what ever is 
between the sc|uare brackets and sulistitute the value in place 
of [command arg arg]. Finally, curly braces are used around 
parts of code you want to execute later and defer evaluation 
until sometime in the future. 

An FI P Cltfnt 

I thought thai a good ck^mo of Td/Tk for the Mac would be 
an FTP client. Now, I didn’t want to rewrite Fetdi or Anarchic, 
but, 1 did want a useful example. The example program works 
but there are many feature.s left for the reader to complete anci 
tlie sample probafify won’t work unless you FTI* to a unix 
system. One develops a lot of respect for Anarchic or Fetch w'hen 
you try to repeat their author's work. 


Bruce O'Neil <l)eoneeI'imacconnccLcom> spends his work time working on astrophysics satellites and his spare time playing 
with his kjvdy wife and children. What time is left is devoted to his PowerBt:x>k. 


40 


An n? Firiui CuiiNT IN Tci/Tk 


MacTECH • rcURUARY 1998 














So. uvcn tlioLigli this is just a simple example, what made it 
good for First; it was quick and easy to write. 1 Ux>k 

about 4-6 hours to write most of the ecxic, witli a little i>it of time 
to dean things up for pulJication* Second, the resulting 
exeaitalile is small at around 27 Kbytes and the I ft is very Mat: 
like. l’h[ti\ the same source wt>rked on more tlian one system, 1 
was also able to am tliis on a unix system pretty much 
unchanged for additional testing and on the nnix system it 
Icxaked like 1 was running a Motif application. Finally T wanted a 
GUI and 'I'ClVIF scK'keLs in my pa)graiu and Td/Tk has all of this 
easily built in, dd>uggcd, and well documented, Plus, you can 
experiment interactively with your code rather thiin eompile, 
link, am, crash, debug,and edit as you must nonnally do. 

There are two downsides to Mac Td/Tk appitcaiions. The 
first is that you have to install TeJA'k. *lhe small appheatitm 
depends on some shared librarie.s, but, you could avoid the need 
to airrady have insialtecl Td/Tk by using lite nun-shared veision. 
The second dt>wn.side is tliai the current version requires quite a 
bit of memory. The default is 4mh but you might have to btirnp 
this up if your programs c:ra.sh. Many crashes are caused by 
ojnning «jut at memory. 

Displaying aWindow 

Tlie first thing tlie user sees when they start the program is 
a dialog produced by the new_cannection prcK, listed below. 
Tlie dialog looks like 



Figure L Open ConnecHon Dialog. 


Be‘(:ausc' Td/Tk is interactive, you could downkrad it from 
<http://sun5cript.sun,com> and type in each following command 
and watch w'hat happens as yoti go. This is a very quick way to 
learn how' TelAk works. 



write java that always^ complies 
on the first try ... . ^ 


O 


CD 


no more edit-compile-curse cycle 

“clean up your language” 

with SpotCheck 

EXAMINES YOUR JAVA CODE AS 
YOU EDIT EACH LINE, PROVIDING... 


(D 





smart links to name declarations 

r:.a 



C:;tt;E;erK 

TM 

JAVA EDITING THE WAY IT SHOULD BE 


www.genieworks.com 
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ncw^ctjnnmkjn 

Thbi h the main dialog tht.^ iLser intemtts with md an example nl Tei/Tk pnjjamming 
This asks the user for their hostname, username (optional), password (optional), and 
director)^ to connect to.When they click the connect button, ft brings up a direaory 
list of that directory. 

# Procedure to open a new connection* * 
proc ne>L_CQrjnection [1 [ 

wf we can access the global variable FTP 
globFil FTP 

# This sets the variable named t to the resnh of the 

# topicvel command 

^ topicvel, like all Ik Widget creation commands re ttirns 

# the name of the widget, 

^ mcw^cotinection in this case, as it’s result. 

set t [toplove! *now_ef>nneeticin -nipnn .menubar] 

win title $t "Open Connection^ 

# create a text 

label title -text “Open a new FTP connection" 

# grid is a geometry managet'lliis puts Uie title on die 

# screen. 

grid St-title -eolumnnpaii 2 

label $t*ho«tl text "lloEitriaine: 

# associate the variable FTPfhostmmc) with a text entry' 

# area on the screen. 

# iK>te that Ltiere © not S before IT P(hoijtname) 

entry $t,hoEte -textvariable FTP(hostname) 
grid St-hostl StHhoste 

label Sl.tiserl text "Username:" 

entry Sl.usere -textvariable nT(U3eriiaine) 

grid St,user! St*usere 

label St.passl -text "Password:" 

# 'Show ’ ceh™ “ rather than the user s keystrokes 

entry St.pa. 30 o textvariable FTP(password} 0 b[)w * 
grid St.passl $t*pasBe 

label St,dirl -texi: "Directory:" 

entry St,dire -textvariable FTP(directory} 

# create a button which when it runs the command up_dir 
button St-dlrup iext "Up" conimand "ijp_dlr" 
grid $L*ditl $t*dire $t.diritp 

# pul up rwo radio buttons to set datamodc.T1cd togcdicr 

# by the variabk option. 

radiobutton St.binary -variable FTP(mode) -text Binary \ 
-value Binary 

radiobutton $t.ascii -variable FTPCmode) text Ascii \ 
-value Aseli 

label St.datamDdc text "Data Mode: " 
grid Si*i3aLamode $L.binary St-aacli 

^ frames bold thiit^ 
fratce St.direc 

label St .direc.title -text "Remote Directory" 

# pack is another ^e^fmetry manager and puts the title at 

# the top cjf this frame 

pack St-d1rec,li lIo side top 

# the follow ing three cointnand.s set up a text box and two 

# scroll bars 

set [iTP( listbox) [listbox St .direc* list \ 

■xscrolicommand [list $t*direc,xscroll setj \ 
-yBcrollcomiiiand [liat $t-direc*yaeroll set]] 
scrollbar St.direc.xscroll -orient horizontal \ 

-command [Hat St.dlrac/llat xview] 
scrollbar St,direc.yscrol 1 -orient vertical \ 
coiamand [liat St - direc. list yview] 

^ these pack commands put the listbox and the scrollbars on 
^ the screen 

pack St.direc.xscroll -side bottom -fill x 

pack St .direc.yscroil -side right -fill y 

pack St-direc-lint -side left -fill both -expand true 

# put the whole frame with the remote directory listing on 

# the screen 

grid St,direc coluiiinspan 2 


^ attadi the event of double mouse button 1 (on the Mac, 

^ double dick) when within 

# the widget St.direc .list to the event of running the 

# command get_file_or_dir. 

# in other words, this sets up a routine such that when you 

# double dick 

# in the list box your routine geurile_or_dir is called 

bind St.direc,list (Double-1> [gat_file_or_dir] 

button $t-connect -text Connect \ 

- command "£Ct_dir St.direc,1jst" 

# destroy deletes a widga and all of Ifs children 

button $t,cancel -text Cancel -command "destroy $t" 
grid St.connect St.cancel 

! 

This erode doesn’t prcxluce the nicest kx>king dialog, but, it'.s 
functional. It would Ix' much preltier if I went through and 
added .space around widgets and added colors. Note that the 
functions of the dialog are quite separate from the layout. This 
allows rue to go through and cliange llie de,sign of the dialog 
without changing the supporting code. 

Connecting to the Server 

Once the user has filled out the connection dialog and 
clicked Connect it's time to get a directory listing. The bit of 
code which talks to the remote FTP server and gets directory 
looks like this: 


ftp_get_dir 

Thi.s hit of code reads the global FTP array variable and returns :ls its result the 
directory lisijng from the remote s-ystern.|t connecLs to FTP(htKstname) as user 
FTTfiLsef name), or anonymous if blank, using a password of FTl'(password). or 
uscr#hosi if blank. It then changes dircaory to FTl'{directory) and gets that dircaoty 
and returns the result as a big string. 

#'riic guts of getting an FTP iliieat>ry. Mole that Uiis is 
the netscape connect, do 

# something, and quit. Really' inefficient bin much easier to 
^ implement. 

proc ftp_get_dir (] ( 

global FTP 

set FTP(data_ 0 ock) 0 
update_status \ 

"Getting directory from site $FTP (hostname] ** 
upda niiin "KstabUshing FTP conneciiori **," 

* connect to the remote system 

see FTP(ftp_sock) [socket $FTPthostnaHie) ftp] 
fconfigure $FTF{ftp_sock) -blocking 0 -buffering none 

- call a roticine ftp_read_line when the rem<ite socket is 

* readable 

f lleevent $FTF(ftp_sor.k) readable ftp_read_l ine 

if ! [ftp^rend] >31 f 
return 

I 

update_ 0 tatu 0 "Logging In ***" 

* send the u.semame and password 

if [[string compare $FTP(username) ''*'11 I 
puts $FTP (ftp_sock) "USER $FTF (usernaniG) " 

\ else I 

puts SFTP{fTp_sock) "USER anonymous" 

) 

If [ [ftp^read] >3] 1 
return 

1 

if ([string compare $FTPtpassword) ""]1 [ 
puts $FTP(fTp_EOck) "PASS $FTP(password)" 

} else \ 
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!! Stop the press! Late-breaking News !! 

We didn’t have time to preptire a glitzy ad so here are “just.the facts”; 

AppMaker 

now supports Apple’s Appearance controls. 

These new controls — part of Mac OS 8 and also available for System 7 — make your program 
look better and also make your code simpler. They include bevel buttons, sliders, progress indicators, 
little an-ows, tab panels, group boxes, and clock controls. They work in both windows and dialogs.. 

Along with the new controls are new Toolbox functions that simplify your code. 

Using AppMaker, it’s fast and easy to create Appearance-savvy applications. 

AppMaker Creates resources and generates source code. 

Download a demo from http://members.aol.com/bowersdev. Try it out, then phone for a 
registration number to unlock the demo and make a full working version. .lust $199, 
AppMaker includes a 60-day money-back guarantee and a one-year subscription on CD. 

Dev elopm en t : 


M »#■-■ * A L 


F.Q.:Bbx 929v;CiraTithaTn. Nffi * FAX Sp-3857 

ho\versdev#a<))xoni ■ htLjr://iTrembers.^.^om/hbwersdev . 




puts $FTP(ftp_sock) “PASS userthosTnaiie'* 

I 

if f [ftp,read] > 3] I 
return 

I 

# dmigc to iJir iisa sdCClid dinccttjry or / 

if ([string compate $FTP(directory) “"J I I 
puts SFTP(ftp_sock) ’^CWD $ETP(directory)" 

) else I 

puts $FTP(ftp sock) "CWD /" 

) 

if t [fTp_readJ >3] 1 
reLurn 

] 

update_statijs “Setting up for transfer ...” 

^ transfer dircaorics in ascii mode 
puts $FTP{ftp_f!ock) "TYPE A” 
if [[ftp_road] > 3M 
return 
I 

* get a server sockci on our s^ siem so dial ihe remote 

# jsysiem can send 

* us the directory listing 

update status “Opening server port 

set serv_sock [socket server notify_connect 0] 

update_status "Setting up to retrieve directory 

set hostip [lindex [fconfigure $FTP{ftp_sock) -Eockname] 0] 
set serv_port [lindex [fconfigure $serv„30ck -sockname] 2] 

^ expr 'Mi h(jw wc do math 

set serv„up [ex.pr “int($serv_port/256)“] 
set serv_lw [expr "$serv_porL $serv_up* 256“] 
regsub all [\*) $hostlp " hostip 


^ scud the port comniaiid lo ttic ncmuiL- sysicm 
puts $FTF(ttp_Eock) “PORT $hostip,3serv_up.Sserv_iw' 
if ][ftp read] > 3 f { 
close Sserv sock 

fileevent SFTP{fTp_.'50ck) readable "" 

close $FTP(rtp_sock) 

return 

I 

^ ijcnd ihc list comimnd 

puts $FTF(ftp_sock) “LIST" 

If |[fr.p_read] > 3] I 
close $serv„sock 

fileevenL tp_sot'k) readable "*■ 

close $FTFtftp_sock) 
return 
I 

update status "Retrieving dir ..." 

fconflgure $FTP(data_SDck) -translation auto 

» keep reading on ihc server socket until end of file, 
vhiie S I Leof $FTF(data^sock)] 1 [ 
set buf [read $FTP(data_sock) 102A] 
append result $buf 
i 

* clean up and exit 

updatG_status ’‘Closing connection * . ." 

puts $FTP(ftp_sock} "QUIT" 
fiieevent $FTPtftp_sock) readable "" 
close ?FTP(ftp_sock] 
close $serv_sock 
close $FTP(data„.aock) 
return ^result 
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'Phis bit of ctxle talks U> a rerrwJle system and implements 
enough of tlie FTI^ prolocol to get a file listing. Basically it sends 
a USER command, followed by a PASS command to log in with 
a user name and a password, 'fhen it sends a CWD command to 
change ic> the proper directory. Next it sends a POET command, 
probably the only tricky bit. The PTP protocol uses two channels. 
The first is the command/resuli channel which is where we send 
commands such as USER and PASS and get resy>onses. The 
second is die data channel which is where we transfer files. This 
is different from the http protocol where we would use tlie same 
channel for both transfers. 

To request a file or directory listing from the remote 
system we set up a server port on the local system and tell the 
remote system what that port number is with the PORT 
command. The remote system opens a connection to that port 
and sends the remote file or directory listing over that 
connection. Tile PORT command has a slightly odd syntax of 
the form A,B,C,D,H,E where the local numeric IP address is 
A.R.C.D and E is ihc port address lugli byte and F is the port 
address low byte. Once weVe gotten the port command sent, 
we send the LIST command. The remote system opens a socket 
to the port we gave it and sends die result. Once we see and 
end of file on our server scx:kct we are clone and can send the 
QUIT command. You can experiment with the Kl P protocol by 
using a telnet client to connect to port 21 on most systems. You 
can also get <hp://nic.mefit jdu/documents/rfc/rfc0959.txt> and read 
all of the gory details. 

Retrieving a file is just as easy as getting a listing. The 
routine ftp_geUile is almijst identical to ftp_get_dir, but instead of 
using a LIST command to get a dirertory listing, we use a RITI R 
command to gel a remote file. Also, we write the file out to disk 
rather than returning it‘s contents as a string. 

Adding a Menubar 

Up to now all of the code has been generic Tcl/Tk. While 
tPs nice to produce porlahie applications, wc use Macs because 
we like them and we'd like our applications to look Mac-like. 
Icl/Tk 8.0 has some nice feamres built in that wc can u,se to 
make the application look more like a Mac. If we create a menu 
widget called say .menubar, and then add an entry to that called 
.menubar.apple, items on this menu will be in the Apple menu. 
So, we add a menubar as follows: 

pm of ihc main prugmin 

This will add the Miic menus such th^t they wort tike Mac rrumus.Wc create a 
mcnubiir named menuhar and tbrn add Appk and File entries to it.The Apple entry's 
wiU appear under die Apple menu as you'd expect and the Fife menu will be the lirsi 
menu after the Appk menu . Well add an accclerstor to the Quit menu option with 
MeU-Q which will be 
translated to (ximmand-Q on die Mac. 

# rnake a menubar 

menu .meuyhar touroff 0 

# add the file mm 

.menubar add eaacade -menu .menubar.file label "File" 
menu .menubar.file -tearoff 0 

# add the apple menu 

.nicnubar add cascade -menu .menubar.apple 
menu .menubar.apple tearoff 0 


# add the about entry 

.memibar.apple add command -label "About,,." \ 

-CO mma n d s bout box 

# add entries to the file menu 

.menubar .file add command label "New Conneetioii..." \ 

-canmand new_connection 
.menubar.file add separator 

# this will be the normal mac quit keyboaal acclcraior 
.menubar.file add command ‘label "Quit" \ 

-eommand exit -accelerator "Metfi-Q" 

# make the menu the menu for the topkvel. window, Whenever 
the - window is the frontmoiit window then the menubar 

I? menubar will be the menti at the top of the screen. 

. configure -menu .menubar 

The only oBier Miic specific ctiirimand is console hide at the 
end (if the program. This prevents the Tci console from 
appearing, 'file I'd coasoie is where you would type Tcl 
commands if you were using Tcl inlemctively. 

The last thing lo do to generate a standalone Mac executable 
is to drag your Tcl source file onto the program Drag & Drop 
Tclets and answer the questions, 'lliis little program will build a 
Tt:l exec:uiHhle wiiich c'an lx: doulile-clicked to run our Tcl script, 

CONt:i.USK)N 

After reading this ariit:le you should have gained an 
appreciation Ibr Tcl/Tk and some things you c'an do with it on 
the Mac. It's also possible to control other programs with the 
'rdAppleSctipi extension, whit:h ships with Tcl/Tk 8.0. This 
allows you to use Tcl to tie logcilKT multiple programs as you 
can with AppleScript, Now that Tcl/l'k has native look-and-feei, 
the Mac Tcl scripts look like Mac pragram.s and Tcl/Tk gives you 
a quick way to write Mac prf>gram,s. 

BmiJcxiiCApHY Am Referfivces 

# OusterhoLit, John K. 7c/ and the Tk Tmikil, Addison- 
Wesiey, 1991 

# Welch, Brent B. Prai teal programming in Tcl & Ih, Prentice 
Hall, 1997. 

Kf>r more information you should check tlie main site at 
<htlp://sunscripl.sun.Com/> and an excellent overview paper on 
Tci/Tk and scripting languages is from 
<http://www,sunlabs,com/-'Oiister/scriptinghtml>. SI 
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CodeWarrior Latitude: Porting Custom 
Definition Functions and More 


This monrh, well continue our 
ongoing look ai CtxlcWarrior liititutle. 
Well Stan off with a look at tlie issues tliai 
<Tr)p up when porting custom definition 
funaions from the Mac to Unix systems 
such as Rhapsody. 

CodeWarrior latitude is a porting 
library tliat greatly simplifies the process 
of porting Mac OS applications to 
Rhapstxly, Uiitude is an impiementaTion 
of the Macintosh System 7 application 
programming interfaces (APIs) tfiat 
allows source code for a Macintosh 
application to be compiled with little 
modification on a Rfiapsody platform^ 
resulting in a native Rliapsody ap¬ 
plication, Latitude maps the Mac API 
requests to native Unix system calls. An 
application built w'itl) Latitude attains the 
look and feel of the new native platform. 

Custom Defimtion Fitnctions 

Customized definition functions 
provided to the Mac 'i'oolhox Aid as 
function pointers require no changes for 
ix>rting from the Mac OS platform using 
CodeWarrior Latitude. 'Ilie function pointer 
you provide to Modal Diaiog(), for example, 
does not need to lx: changed. However, 
you may want to add functionality to your 
mtxlal definition funaion to handle events 
lliai wcTcnl expected on the Mac. 

On platforms supported l>y Latitude, 
modal dialog windows are moveable at al! 
limes. Tf the user moves a mfxlal dialog 
window, the mouseDown tnDrag event will 
go undetected in your own modal 
definition function pf>rted from the Mac 
since on tire Mac your app didn't have to 
deal with this possibility. Therefore, you 


will need to add a case for tlie mouseDown inDrag event, which 
('alls DragWindowO to handle that event's processing. You will 
know if you neglected to handle the mouseDown inDrag event if 
your dialog window contains a [Hjpup meniL If DragWindow() has 
not Iteen called in a moved window and tlie user clicks on the 
popup menu burton, the menu will appear on screen were the 
popup Imtton was on die screen f>efore the window was moved. 
Ihe DragWindowO uixlalcs the window's pirt fK>unds which 
are used by PopUpMenuSelect() to display the popup menu. 

Because this new po.ssibiliry of unforeseen events arises on 
non Mac OS platforms, your own application's windows may 
become obscured or uncovered at times when diey couldn't have 
been on the Mac. For example, say the user causes a system 
dialog U) appear, such a,s one of bititttde's “Apple" menu desktop 
services like Copy Files or other system level alerts which are 
movable, and then the user moves one of these alerts causing a 
ponion of your own app's windows to require updating. You 
now have a blank area of your application windows that you 
want to refresh. But, you don't iiavc conm:>l since Latitude is 
servicing some other request. 

Latitude provides a means for applications to register a special 
modal filter function whose job is to receive update events for al! 
application windows when Latitude is in control of a presently 
displayed modal dialog. The filter fiinction prototype is simply: 

void my_app_mDdal„uijdatt»_hgok(EventRecord *theEvent) 

You provide this fimetion at lg_latitude_init() time as one of 
the field sellings in the LG_APP^INFO_BLOCK: 

void mialnC long arge, chai: “argv 3 

I 

#ifdef _iATlTUDE_ 

LC_APP_INFO_BLOCK Iblock: 

Iblock,flags = LG APP^TNFO^STGNATURR | 

LG_APP^iNrO_CLASSNAHK | 

LG_APP_LNi:0_K01}AL_E VENT^BOOK: 

1 block,signature - QUAfiCONSTl *C\J 

lblock*ciassnaiiie = "Latitude*: 

ibiock,Biodal_eveiit_hook - iiiy_app._modal update hook; 

lg_iatitiide_iiiit (atgc. argv, Alblor.k): 
i^endif 

Another type of custom definition function are tluxse tliat define 
aistc.)m controLs, menus, lists, and windows. Mac applicatioas 
provide these fijnetions to the Mac tcxilbox in one of two ways. 
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They either compile these funciioas separately into spedal code 
resoun:e.s — CDEF for controLs, MDEF for menus, LDEF for lists, and 
WDEF for windows — or they compile these hinc^ions wilii iJietr 
application and patch sptx:ial CDEF, MDEF, LDEF, or WDEF 
resound that coniain assembly iastructioas. These patch resources 
typically contain twelve l^e smictures defined like this: 

typedef fttruct t 
shc^rt Jinp_liist; 

Fr^sePtr long def^func; 

J DEF_STRUCT; 

And are set up ai init time like tills: 

I>£F_s™CT "*ray_cd€fv 

extern long ciy^cdef(short varCode, ControlHaodle theControlt 
short message, long param); 

tny^edef - (DEP_STilVCT **) Getftesoure( ^ CDEF * * 128): 

('*niy_cdef). jmp_inst “ 0 k4EF9: 

/* rtrtlJxft for JMP (Le.jiimp) 7 
C* *iny_cdef) .def_func “ (ProePtr) my_cdef: 

ITiere are two pnibleias with this practice that come up for 
porting. The first problem is the 680x0 assembly code in the 
handle. Since CodeWanior Latitude contains no machine ctxle 
interpreter, the 680x0 JMP instnicfion i.s meaningless. The second 
problem is a little [qss obvious and far more hazardous. Since 
we're probably porting to a RISC based platform where long 
words are aligned on long word bountliries, the nsizc of the 
DEF^STRUCT staicture al>ove is not 12 bytes, it’s l6! (llie 
compiler will insert 4 bytes of padding after the jmpjnst niemter 
so that def_func falls on a long word boundary.) The size of die 
CDEF 128 handle is !2 bytes. The assignmcni of the structure's 
defjunc member writes passed die end of the 12 byte handle, 
thus coiTupling memory. 

CodeWarrior Latitude provides a means to register your 
definition functions so as to avoid these types of prolilems: 

Handle lg_latilud^_COde_[:esouEce(ResType type, short id, 
StclngPtr name. PtoePtr dafproch 

Latitude creates a special handle and places it in the ROM 
Resource Map (ROMMapHndl). When Latitiidels tcxilliox 
requires a CDEF, LDEF, MDEF, or WDEF, it searches die ROM 
Map for the registered code resource first. 

If your app needs itj get at die liandle, you can use the one 
returned by lg^latitude_code_fesource(), or if that one isn’t readily 
available, you can use regular Resource Manager calls to retrieve 
it. 1he standard way to gel a ROM miip resource is: 

short cur^map: 

Handle h; 

ciir„Kiap " CyrResFileO : 

UseResFile(l): 

h = GetlResource(QUADCONST{X\*I>*,*E\'F'). I28h 
l)seResFile{cyr_nuip) i 

To get the fimetion pointer out of a CW Latitude created 
code resource handle, use the call 

ProcFtr lg_latitude_code address(Handle h); 


CDEFs, LDEFs and MDEFs for popup menus are completely 
handled by (2W Latitude. MDEFs for menus off of the menubar 
need to be handled differently since CW l,atitude Is not drawing 
those menus itself but rather sending die appropriate instruaions 
to the native system to display the menus. 

If your app has a custom MDEF for menubar menus solely 
for the purpose of displaying multiple key combinacion menu 
item key equivalents (such as shifl-control-opCion-F), then you 
can use a special MDEF provided by CS^ LaLiiude, called 
lg_(ati1ude_custom_mdef, specifically designed for such menus. 

WDEFs arc also a little tricky. Again, CodeWarrior l^iiiudc is 
not drawing the window itself, so you have no way of drawing a 
window's adornments under latitude. However, by using some of 
liitirude's special window functions like lg_latitude_next_window 
(discussed in last month's article) and lgJatitude_fegister_window, 
you can provide Latitude with a description of the fiinaionality of 
your WDEF^ including floating attributes, and let Latitude handle 
comniunicating those details to the native system. 

Games wmi A5 

Macmiosh applications have all kinds of games they play 
with the A5 register to save and restore contexts. Sometimes this 
is done when the application i.s in the background but wants to 
communicate stimcihing to the user. Since the native Utsrx 
sysieim supported by CodeWarrior Latitude do their t)wn context 
switching, your applicaiion cioesn'l have io provide its own 
context management If your apiilication is awoken horn 
suspension, you can be assured that the system w'ill restore the 
proper stack and processor register context before executing 
more of your application’s code. 

Some applications use A5 as a sort of stack jump maneuver 
to recover from an error, Tlie equivalent in Unix systems is the 
seljmp and longjmp pair of functions. You itst* seijmp to save the 
stack environment in a given buffer fot later use by longjmp. A 
call to longjmp zaps execution and context back to the plac'e 
were the setjmp call was made. 

Games wrru the Memory MiiNAGER 
St)me Macintosh applications play interesting games with die 
Mac Memory Manager. They try in gobble up all of die memoiy 
available, tickling a grow zone proc in the pixxess, to deteniiine 
how much memory is really available. Others allocate a large 
block of memory and proceed to parse off parts of it ihemscives, 
acting as their own Memtiry Manager. CodeWarrior Latitude’s 
Memory Manager provides handles and [xiiiilers the w-ay Mac 
applkuiions expect, even simulating a System Zone and an 
Af^plication Zone. However there are no large, specially zoned 
pcxils of memory that Latitude allocates from. 

F^ch handle and pointer allocaiion done by CW Latinide's 
Memory Manager Is mapfied direedy to Umx system malloc'O and 
reallocO calls. Since weYe operaiing in true virtual memory 
systems, rhe.se common games applicalion.s play with the 
Memory Manager are completely meaningless. If your app is 
using these tricks, you should disable them and just let LatiCude's 
Memory Manager do its thing. 
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PRECX>MPn J^D Hjeaders 

On Latitude supported .systems where tlie available 
compilers do not support precompiled headers, you will have Co 
explicitly add inclusion of your desired include files to your 
source cxide. It will prr>babiy be helpful to create one include file 
that sites the set of files included in die precooipilecl header you 
used on the Mac. CodeWarrior Latitude includes an inckide file 
like this ftjr the often used MatrHeaders file. It is kK'ttted in the 
$LATITllDE_ROOT/utilities directory. You can copy it to your 
application's development environment for your use. 

At the Lime of this article's writing, Metrow'erks has not yet 
released our own C/C+’+'/ObjC compiler for Rhap.sody. 
However, by the time this article hits the stands, this issue of 
precompiled headers will be moot for Rhapsody. However, 
until w^e bring the IDE to Rliapsody, you will still have to 
explicitly add any includes that were implicitly added by the 
IDE's prefix file feature, W 


Visit MacTech® Magazine’s Web site! 

http://www.mactech.com 


PrimeBase 

Prime Power Online 


TM 



High-performance Relational DBMS 

Now available for Rhapsody 


Open System: ODBC. SQL. DAL ConipMani 
Scalable from 68K Mac to IBM RS6000 
Proven Reliability (fomierly PJNK SQL! wilh insiailaiitjn.s 
around die world 

Cross-platform: Rhapsody, MacOS, Windows 95/NT, Sun 
Solaris, Linux. 

Competitive Prices (i 0-user server for Apple Hardware or 
PC only $820) 

Highly Flexible Web ConDectivily available 
EOF Adapter for OpenStep and Rhapsody 
Single-u.ser Kuntinie available 


Developer Keys 


SNAP Innovation GmbH 
Tel: +49 (40) 30636400 
Fax: +49 (40) 30636333 
sales ® pnmebase.com 




Download Now! 

www.primebase.com 



Dilberf' by Scoll Adams 


I 

I 




BY nY CMCULMI0N5, 
WECANMAKEmiaON5 
BY COnBINlhG A 
MORTUARY BU5INE55 
ANDAGARBW5t 
coiLECTioN mmb. 


OUR CU5T0nER5 COULD 
SmPLY LEAVE TRE 
DEARLY DEPARTED BY 
THE CURB FOR PICK-UP. 


491998 United Fs^ure SyrKlteate. InC. (NYC) 



February 199S * MacTech 


CodkWamkiok LAincJDE: Purling Cusuom Deiinition Funoigns and More 


47 












































PROGRAMMER'S 

CHALLEIUGE 


b}f Bob Boonstra, Westford, AIA 



Image Decoder 

This month's Chalion^je is much ciisicr to stale than ii will be 
tc^ implernenL. Your task Uiis month is to write a decoder for 
Gra[>hics Interchange Format images. GIF is a daia slream- 
oriented tile format used its define the transmission protocol of 
L7,W-encoded hitiiiap data. Your code will read a file containing 
a GIF and draw the image in an oflscreen gntphics world. There 
are two versions of the GfF spetaficatitm; this Challenge includes 
only the earlier and more common GIP87a format^ not the 
GTF89a fonnat. The format description is too long to inLiude 
here, but you cun find the GIF87a specification at: 
<ftp:y/ftp.rKsa,uiiJC,edu/misc/fHeiofm3tygraptiic5.format5/gif^^^ 

Ollier useful inlormution on graphics formats in general is 
available at: 

<ht1p://www.ds.ohiO'State.e(jLi/hyperte)(tyfaq/Ljsenet/gfaphic5/fileformalS” 

faq/Top.html> 

Tile prau;>type for the code you should write is: 

IlneludR <QD0ffscreen.h> 
ifindude 

CWgcldPtr fteadltTH^d?(FTTiK 'InputFile) ; 

'Hie inputFile will have lK"en opc'ncd for yttu in binary mode 
by the tailing rtniline. Readlmage should read atid parse the 
image, cTeate a GWorld w-iih the apprapriate color table, dniw the 
image in the GWorld, and return a GWorld pointer to ilic t'alling 
routine. 'Itie st^lution that correctly decodes a variety of image.s 
in the least amount of execution time will l>e the winner. 

1 thought for some time alxau the CompuServe / I’nisys / 
LZW parent controverty lx:forc .selecting this ttjpic for the 
Challenge. The LZW algorithm used in GIF compressitm Ls 
patented by Unisys, and Unisys requires that any commercial 


software product that uses this algorithm, inciuding software that 
reads GIF images, requires a lic:ense from Unisys. Freely 
distributed software does not require a license. Since the 
Challenge doesii’t result in a software product, much less a 
commercial product. I decided to go ahead with this exploration 
of decoding efficiency. 

Tins will be a native Powerl^C Challenge, using the latest 
CodeWanior environment. Solutions must Ik* coded in C, C++, or 
Pascal. 'Iliis Challenge was suggested by Peter Lewis, who earns 
2 Challenge |:x)inLs for the suggestion. 

Three Mon riis Ago Winner 

Congratulations to Jeff Mallett (Boulder Creek, CA) for 
sulmiitling tlic winning entry to the Pence™ Challenge. The 
objective was to accumulate, in minimum exec’ution time, die 
mo.st points in a round-robin lournamenl of the hoard game 
Penie™. With only three entries, the toumament required only six 
games for each player to compete again.st each other player twice, 
once jilaying first and once playing staiond. Bt)th the winning 
entry and the third-place entry l>y Kandy Boring employed an 
alpha-beta search ledinique to find the be.st move, and both 
entries were successful in winning most of their games. Jeffs 
entry, how^ever, w^as more effideni alxiui pruning ilie search tree 
and therefore required significantly less exeaition time than 
Handy's eniry. Since a point was deducted for each second of 
execution time, the winning entrv^ lost significantly fewer fxjjnts 
for inelficienty. In addilit)n, the storing algorithm in Jeffs 
AdclStone routine lakes advantage of all three methods of scoring 
|X>inLS: captures, winning by placing S siones in a row, and 
leaving sequences of 4-in'a-row on the Ixnird ai the conclusion of 
a game. His solution earned more txjinls as a result, even though 
it won die same number of games as Rantly's. 


THE RULES 


Ikre'ii how \i works; eadi monih we presem a new pro^’minmlng 
challenge. Fir.sl, write some ct>de ihai solves liie diallengc. Second, opiimizt* 
your code (a lot). Then, submit your seduUon to Muel’edi Maj^a/ine. We 
choose a winner based on code correctness, speed, .size, and elegance fin 
dial order of im|x>itance) a.s well as the sybmi.ssion date. In the rwent of 
mulliple equally desirable solutkjn.s, well chcM)se ime wanner (with 
honorable mention, bui no prize, given to the runner up). ITie prize for each 
montICs Ix’st solution is a SI (Ml cr^ii For Developer Depta’**. 

Unless siarttl r)chiwi.sc in the poiblcm statement. iIk* following rules apt)ly; 
Ail soluticm-s must i>e in ANSI compiitible C or C++, or in Pa.sral. We dLsriualify 
enlries with any assemlrly in them (except lor challenges spcxifolly stating 
otherwiseJ yim may c;ill any .MaduKjsh Toollxjx rtiutine (e.g., it doesn’t matter if 
you LLse NtwRr instead of ntallcie). We aati|iile all eniries into native PowerPC 
rrxie with compiler o|XHirLs set lo enable all available sT^eed ofXinnK;ilions. Ilie 
development envininraeni U> be iisctl for .sek'tting the winner will lie staled in die 
probletn. limit ymir code to 60 eliaratlcrs per line ix coniprt'ss ami binhirx the 


soluiion; ihis helps with e-mail gaieways and ixige layout. 

We publish the solution and winners for each niontlVs Programmers 
Challenge three momKs later Alt suhmis.sions mu.si Ito reteived by the 1st day 
of tfie inondi printed on the front cover of this issaic. 

YtHi can gel a hc^rd start on the Clvallenge by reading ihc Programmers 
(Challenge mailing li.st. It will l)e ptjsied to the list on or before the 12th of the 
pnxreding mivnili. Tcj join, send an email lo listsetvSlhsirnail.xplain.coni with 
the subject ‘subscfibt! challenge-A*. 

Mark solutions “Attn: Programmer s Challenge Solution" and send il by 
e-mail to one of the Frogranmier'.s Challenge sidclnt^'s in the “How to 
Communiole ’With Us" section on page 2 rT this issue. Include the solution, 
all related nie,s, and your a ml act info. 

.MatTech Mag;i/ine reserves the riglu it> pufilish any stduiion entered in 
the Pmgrammers Challenge. Authors grant MacTech MagayJne the exclusive 
right lo publish entries w ithout limitation upon suhmi.s.sinn of each entry. 
Authors retain copyrigiits for the axle. 
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Spotlight Memory 


Debugger 

Spotli^»hr is [he linit aucomiiiic memory 
debu^^T f(,)r the Macintosh. Instat^dy 
detect invalid memory acresscK, memory leaks, bad 
toolbox parameters, stack ov'crwritcs, memory relo¬ 
cation problems, and more. SfKJtlighi caji find prob¬ 
lems in seconds that mi^^ht takt: you a week to Ik by 
hand. 

Spotli^^ht uses your XSYM file to auiomaLidUy 
patch pur PowerPC native ajjplicatioii Vtlien 
Spoilijfht detects an error it brings up die exact 
souRe code line whttre the eiror fXTuned along 
with stack crawls, memory views, and pRjgram \^ari- 
able usage information. 

No need to change: your source code. No need 
to recoin pile. No learning c urve wiiaLsoever. 

Spotlight's Objeci Code Refilacement irisirumen- 
ration inspaxs each PowerPC fiiXKessor memory 
read and write instruction in your aide as it is run. 
Spodight detects faulty memory reads and waites 
that occur between bloc'ks, in released hkx^ks, 
across multiple blocks, and outside of ptir heap. 


I NEW I 


VERSION 




Features 

■ Stops your program on exact 
soiJRC axle line whert^ a !>ad 
memoiy wriie occurs 

m Complete leak reporting with 
source cixle stack trace show¬ 
ing fxmu of allrxation 

■ Fully validates parameters to 
over 400 Mac ttxilbt>x API 
calls. 

m Works on ail hea[) aikx^doiis 
Mac Tcx>lbox, C 'malloc', 

C++ new and delete. 

m Supports any language that 
[irtxluo.'s ati MPW'or 
Metrowerks XSYM file. 

m Full logging and ignore apabilitit's 

■ API for fine tuned contml 

■ Pun’hastr int lutk^i ( mic year subscription to 
dowtdoadalile ujxlates 

■ 30 day money hack guarantee 

■ Available for secure electronic purchase now 
at our web site 


Requir^ents 

Mtidruosb or AUic (Bcmipiotihle compuier with a PPC (01 or 
gre4tter processor, /ZMf requirmran tis tmy rw iar- 

^ a}>[iiicaiinrj sj^; 2 Mb bemt disk Syskm 7.5 or iaier; 

Meirou'erks or MF^' cotnptUibie sjrfiboiicpie 

Downkxxl IhxrdemoaL http://www.onyx-tech.com/ 

$ 199.00 

TEL (?4I}W7S01 E-MAIL salcsC^Miyx icclicam 

FAX ^941)79S’W1 UWL hltp://www.i)nyx^{di.Com/ 


The Lil)le Ik4ow lists the aumlx.Tof tournament wins, pr^inrs 
earned, cuaiulative score, axle si7.e, data size, and programming 
language for each entry. The niimtxrr in parcnilie.ses after the 
entrants nanie is the tcJtal number of Challenge points earned in 
all Challenges to date prior to this one. 


Name 

Wtii% 

lyiinbi 

Score 

Code 

Dala 

Language 

Mallcti 04) 

5 

3.3 

32,03 

4^r72 

792.3 

c 

Sdnusiuuj Maurer 

0 

m 

9.97 

'IS60 


(;++ 

Kandy ({i6> 

3 

23 

-374,90 

7672 

2f>-iy 

c 


Top 20 Con^ti^tants 


Rank Name 

Points 

Rank Name 

Points 


LMunter, Ernst 

200 

11 .Higgins, Charles 

20 

2, Boring, Randy 

73 

12.Larsson, Gustav 

20 

3.C(K)fX.T, Greg 

6) 

13 .Studer, Ihomas 

20 

4. Lewis, Peter 

59 

14.Gundnim, Eric 

15 

5.Mallett, Jeff 

50 

15,Hart, Alan 

14 

6.Nk:f>ile, Ludovic 

48 

l6X)'Connor, Turlough 14 

7, Murphy, ACC 

34 

n.Picao, Miguel Cruz 

14 

8, Gregg, Xan 

33 

18.Saxion, Tom 

12 

9, Antoniewicz, Andy 

24 

19Cutts, Kevin 

11 

10. Day, Mark 

20 

20.8-way tie 

10 


Here are the Top Contestants for the Programmer's 
Challenge. The numbers l>elow include points awarded over 
the 24 most recent contests, including points earned by this 
month's emmnLs. The scores have fx^cn adjusted to correct an 
error made in assigning points for the Stratego Challenge 
printed in the November issue. 


'there are three ways to earn points: (1) scoring in die top 5 
of any Challenge, (2) l>eing die first person to find a bug in a 
published winning solution or, (3) l’>eing the first perstm to 
suggest a Challenge that 1 iLse. Ttie poinus you can win are: 

Isi place....20 points 5th place ........2 points 

2nd place.10 points finding bug...2 points 

3rd place.7 poinLs suggesting Challenge...2 points 

4th place........4 points 
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Build great applications... BottfiF 

Cheaper 
Faster! 


Great 


Tools Plus 


LIBRARIES + FRAMEWORK 




Make cool apps while others are still reading their manuals. 

Professionally polished. Wickedly fast. Delightfully efficient. 

'“l.tbe routines arc more compact and faster 
ih^n ^nythtng you tmghf write .^. f very alemeni 
of TfX>fs Phis k useful,, a bargain compared 
with coding these routines yourseif/' 




You build the interface. 

Tools Plus provides the infrastructure. 

It makes all your pieces work together as an application. ■ 
With only a few hundred routines, Tools Plus thins your code 
by tens of thousands of lines. You see results sooner. 
Changes are a snap. i 

^Alf in aff ifs an incredibly rich collection of tools.., 
if you are interested in developing appiications 
that have "quatity" written all over them, then 
roofs Plus is for you. MacTech MAGAZINE 


Here is Jeffs winning solution: 


MyPente.c 

Copyright© 1997 JelT Maileit 

if 

// Do a dcptii^l scardi to sort move??. Then do a higher 
// depth alpha-beta starch to select the best move. 
if 

// Plays for score rather than to win. R>r example ^ 

// tlotsn't tr)' to win by getting S captures Since 
// there is no score incentive for this. It could be 
// retuned to play for a win instead. 

^include “Pentenh" 

//define SEARGH_DEPTH 4 
enuin 1 

_FRIEND = 0x0001, 

= 0x0002, 

.EMPTY = 0x0004, 

.WALL - oxoooa 

1 ; 


//define BORDER 
//define BORDERS 
//define TKFmiTY 
//define NA 
//define MM.CELLS 


1 

2 

32600 

0 

(31 + BORDERS) 


(31 + BORDERS) 


//define ESTIMATE.PLOS 1 
//define WIN 2000 

//define CAPTDRE_SC0RE 240 
//deCtnc VULNERABLE 130 


r 

OK 

) 

L 

OK 

J 

OK I 



til 


f Styb "Vj 



1 -1 

i 1 

i _19 




<51^ 


- jflWr.. 


A 



□ 

m 

o 


o 

w 

c? 

M 

a 


Yes, Tools Pius has it! 

♦ Create any element using a single routine 

* Everything works as soon as you create it 
» Automates all standard GUI efements 

* Windows, Tool bar and floating palettes 

* Buttons (£1 II kinds, flat and ID) 

* Scroll bars (speed control, live scrolfmg) 

* World-class custom controls 

* Fields (w/scfoll bars, filters, auto-edIting) 

• Picture buttons (the best anywhere) 

• List boxes 

* CDEF and LDEF automatfon 

• Cursors (color animated^ auro-change) 

• Menus (pulWown^ fiierarchtcal, pop-up) 

* Edit menu {undo/redo, automatic cdiimg) 

• Panels (30, grbop boxes, lines, |.>anes) 

• 3D titles (raised or inset) 

• Extended nnulti-monitor and color support 

* Clipboard automation 

• Dynamic alerts (no resources required) 

• Evenl processing automation 

• Over SOOK of custom fonts, Icons, cursors, 
and f)lher useful resources 


Pius thousands more exdting features and services! 



-Hesutts:— 
IS Radical 
□ Slick 
^ RaulR* 


- ^ 

1I t 


j Pand Raised Pan^l [ 


11311 


uperCDEFs" 


$89 value 

i/prDiflssianally dealgned and crafted controls 
✓dozens et 3D & flat buttons, tabs, sliders 

Tools Plus for 

Synvmlec (THINK) £:/C4-j- (68M) SHlt 

THINK Pascal {MK) 5141 

THINK C/C++ think Piscal $149 

CodeWarrkr OrckitiTf^ 5144 

CoefeWarrief Gold (GSKand Pfm trrPa 5241 

lW^ acefipi VISA arid Mies only. Add STO fcf jh|iffln| 5 .j 
-qiail fflf A£ad|ph>iciidrji^ ’ 


WatcT'^5 Bdge 

3441 Koad Wtst Bi^k 20022, 

OakviJie, Onisf;<j Caiuila 161. ljM4 




Phone: (41 fij 210^5628 



fiXi C40^a47-l(>3a 
WdterEdgS W'^'’iiol.toni 


Free Evaluation Kit: 


Available at our web site 
h( ip://www,inlerIog.c(nn/ - water edg 

Softvwatfe 


static shotrt CHA1N.SC0RE2 [3] [3] 

1 NA. NA, NA I, 

1 -U -5, -2 U //FRIEND 

1 1. 9. 2 1 //ENFMV 

1; 

static shoil C1JA1K.SC0RE3 [3] [3] 

I M, NA, NA L 

I 3, 16, 40 [. //IRIEND 

I -2* 10.-30 I //Emm 

): 

static short GHATN_SCORE4 [3H3J 
I NA. NA, NA h 

I 230, 240 , 230 ] . //ITIIEND 
I 150, 155. 160 I //ENEMY 

I: 

static short CHAIN.,.SC0RE5 f3l = 

NA, WIN, -WIN 

h 

// 1 2 ,3 ^ 
static short liLaCK_SCORE [51 = I 
static short THREATSLJ ^ \ 

KA, NA, 

25, //2:lria 

30, // 3: li:£ir-tjpen luiir 

350, //4: double trlas 
370, // S: tria + lialfopcn four 
450. // 6: tcssi ra or 2 halfopcTi fours 
500, 500, 500, 500, 500, 500, 500, 500, 500, 500 


static shact gPreScore(MAX..CELLS], gEstimates[NAX.CELLS]: 

static short ’gEstitnatesStart. ‘'gKstimatesEnd : 

static short gRoard[MAX.GELLS], *gBoardStart, ‘gBoardEnd: 

static short ’gFirstStorie, *gLastStone: 

stEitic short "gKlllers [SEARC1I_DEPTII] * gPreviousThreats: 

static short gDitections [8]. ^gDirectionsEnd: 

static short gMoveNum, gScore, gStartDepth: 

static short gBoardHalfSiza. gSideLength, gBoardMax; 

static short gCuinCapturesFrlend , gCumCaptureaEnetny: 

static short gAd jusTmcni:, gSE; 

//define ADJUST (a) ( (a) f gAdjustment ) 

//define TKANSLArE(x, y) \ 

(gSideLength * ADJUST (y) -1 AD JUST (xj) 

#define GET.INDEXfp} ((p) - gBoard) 

//define GET_X(i) ( ((1) % gSideLength) - gAdjiintment ) 


^ E//|color||o|X’n| 

= l//1ailiirl|n[K:n| 

^ (//fador|[upcii] 

i //fcxjlurl 

NA, 0. 14, 14, 22h 
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Jdefine GET_Y(i) C Ui) / B^JidsLength) - gAdjustment ) 

ffdefine UPDATE^EHDPOINTStpSq. a. b) \ 
if (pSq < a) ft “* pSqj \ 

If (pSq > h) b = pSq 

ffdefirxe OPPONENT (sldej {1 ' tsldej) 

^define OCCUPiEO(x) iU) k (_FRIEND | .EHEHY)) 

^define EMPTY(x) ((k) ^EHPTY) 

//pdhangcs — Array of umigacti Jongs conPining tbp m 
// undo moves 
// list of 

// <i>ointer to position> <old position vaiuo 
// terminated by n OJ, 

static unsigned long gnbarigon [256], *gChangesEnd; 

^^define BUSH^x) * (gCbsn£ef!End+^} = (x) 

tfdefioe START_SAV£ PUSII(OL) 

^define PUSH_SQCpSq) V 

i PtfSH( £long) * (pSq) 3 : PUSH( (miHlgned long)(pSq)3: 1 
^define POP *(-gChangesEnd) 

^define TOP *gChangesEnd 

static short * CbooscNnxtMoveC): 

static siiort AddStone{shQrt Alpha. short beta, short *pSq. 
short color, short depth, 
short captutesFriend, short cAptutesEnejityi 
short *firstStone, short *1afitStone): 
static long MyFindCaptures(Capture capture!]* short 'pSq, 
short us, short then)r 

static Boolean MyFindFive(short *pSq. short color): 


Joitftnte 

void InitPente( 

long boardHal fSite /* e g . 9 for a 19x19 l?oard 7 

r all ecH)rdjtucto between dx^ardlJallSi^e 
ami +hoartlHalfSizc 7 

) ( 

short i, J, *pSq; 

gBoardHalfSize “ boardJialfSlze; 

gSideLength “ boardHalfSlze ' 2 + I + BORDERS: 


gSK " gSideLength + 1: 

gf)1r<icMonfi[Dl - -gSE; //MW 

gDircctions [ l) - ‘gSideLength: //N 

gDirectlons [2] gSideLength f 1: //Nl: 

gDirections [3] * 1: //W 

gDirectlons l4j = gSE: //SE 

gDirectionshl - gSideLength: //S 

gDirecT.iQnsf6l “ gSideLength - 1: //SW 

gOirccrJonsf?} ^ i: //E 

gDl recti on sKnd “ &gDirectioiisL6j: 


gBoatdNax ^ gSideLength “ gSideLength: 
i = (gSideLength + 1) / BORDER: 
gBoardStart &gBoardti): 
gBoardEnd “ &gBoard IgBoardMax ^ i]; 
gEsiImaresStart = igEstimatesli]; 
gEsLlmatcsKnd “ &gEatiiaates[gBoardMax - i]: 
gFirstSLouc gBoardEnd; 
gLastStone “ gBoardStart; 

pSq ^ gBoard: 

do I 

‘pSq - WALL; 

I while Cf+pSq I” gBoardStart): 
do i 

•pSq - .EMPTY; 

1 while (++pSq J= gBoardEnd); 
do ( 

•pSq « .WALL: 

1 while (f+pSq < igBoardIgBoardMax]); 
for Ci - BORDER boardialfSize *2 + 1; 

KgBoardKax'gSideLength: i += gSideLengih) 
for (j“0: j<B0RDERS; f+j) 
gBoard[l+J] - ^WALl; 

gCuuCapturesFriend " gCumCapturcsEneiiy = ^oveNun 0; 
gAdjusttaent = gBoardHalfSiEO + BORDER: 
gStartDepth - SEARCO^FTH - 1: 


void Rente( 

Point opponentsMove» F your opponent moved hert V 


Pentc 



Your Total Bug Trotking Solution 


"If you're a developer, you've got to get Te§tTrack. 
Your bags will hate you for H!" Cool Tod of the thy 


Discover the tool today's top software developers ore using to improve the 
quality of their Macintosh and Windows applications— TestTrock 


Truk bugs, fealure r&quesfi, problems, 
customer information, and more. 

New! E'morl nolificatkirts—SMTP and MAPI. 
New! Import bugs via e-mail auiomatically 
Produce cofv^ reports. 

Mull^le users, full securlty-^nk engineers, 
testers, mnnagefs, even tech writers. 

New! Improved help desk supporl. 

New! Deferred defect numbering, externol 
Qttochmeni iterage, cusiomef bug hhlofies, 
and mud), much, more. 

AutonKTlicully route bugs lo teom members. 
Track the history of each bug. 

Save lime and improve tech support by 
giving Sola Bug, TeslTrock's slond-alonc bug 
reporter, te your customers. 


sole5@seapine,(om 

hltp://www.seapine.com 


Only $16912+ for $149 eoch! 
To order coll 888-683-6456 
or 513-683-6456 



Downlood our demo today! 
http://www.seapine.rom 



Boolean playingFicAi, 
Point •youcHove, 

Capture clainiCapTuresiJ , 
long •tiuiriCapturGa. 
Boolean 'claiinVictory 

) t 


F igutiitr opponcUlMovc 7 
F rttum your mow htrt ’/ 

F rcium t aprured fKiir^ hcfu 7 
F ruium • of cblmCbpiurth 7 
F fctuni true if you datm 
victory with thb mewe 7 


Point move: 

Capture opponentCaptuces[8]; 


Abort 'pJvq, ’pNewSq, *d: 
abort score, bestScote, i: 
short 'pBeatMove; 


'numCapturea = 0; 

•claimVictory “ false: 
if (playingFiist) f //^‘•MOVEl 
trove.h ^ ffiove.v 0: 
pRq = &gBoard[TRANSUTE(0, D)]; 

*pSq ^ _FRTKND: 

LIFDATE_£NOPOTNTS{pSq. gFirstStone, gLaatStone): 
*yourMove ^ move: 
gMoveNum “ 1: 
return: 


i - TR AKSLATE {opponent sHove, h, op po tie n t sKove, v): 
pSq * igfloard [i] : 

"pSq = ^EPfEHY; 

irPDATE_ENDP01NTS(pSq, gFIretStone, gLaatStone); 
++gHoveNum: 

if CgMoveNum = 1) I //***MOVE2 
move.h ^ ntove.v • -2; 
pSq - ^gBaardrTKANSUTE(-2p -2)]: 

*pSq = _FRTEND: 

UPDATE_KNDPOINTS(pSq. gFiretStone, gLastStone): 
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•yourMove = move: 
gHoveNua “ 2; 
return: 


if (gHoveNum = 1 } \ //“MUVfS 

if CopponentsMove,V < opponentsHove^h) i 
if (opponentsHove^v < *opponeiitaMove.h) | 

// t()p 

move»h “ 0; 
oove.v 4; 

I else I 
// right triangle 

move. h “ 4: 

[nove*v = 0: 

I 

I else I 

if £opponentsMove,v >= -oppnnentsMove^b) j 
// tKittom triangk 

ijiove,h = 0: 
move^v = 4: 

I else i 
// left triatigic 

moveph “ 4; 
ffiove.v “ 0; 

1 

1 

pSq ” ^gflourc) fTRANSLATE (move * h * move * v) ]: 

*pSq - _FRiEWD: 

UPDATE^ENPPOINTStpSq. gFicstStone^ gLastStone): 
‘yourMove ^ move: 
gHoveNua - 3: 
return: 


gChangesEnd = gChsnges; 
gCumCapturesEnemy += 

MyFindCaptures(opponentCaptures. &gBoardfil, 

ENEMY» _FRTEND): 

for £pSq " gRstimatesHtert: pSq t= gEsLimaLesEud; ^^pSq) 
•pSq “ 0; 

for (pSq ” gFirstStone: pSq <= gLastStone: ++pSq) 
if [OCClJPIEll(*pSq)J f 
d ^ gDirections: 
do I 

pNevSq “ pSq 1 *d; 
if (KMm(*pNewSq)) 1 

gJisliiiiatestGET_lNDEX(pNewSqU +- ESTIMATE_PLUS; 
pNewSq *d: 
if (EMPTYt'pNewSq)) I 

gEstiaate£(GET_INDEX(pHewSq)l t- ESTIKATE PLUS: 
I 
i 

I while {’H-d I- gUfrectlonsEnd): 

I 

for (pSq = gBoardStart; pSq gBoardEnd: -H-pSq) 
if (gEstiaaieE[CET„INDEX£pSq)]) 1 
i = GET_INDEXCpSq): 
gScore - gEstiraatesfll: 

gPreScorerU “ AddStone£ INFINITY. INFINITY. pSq. 

_t'RlEND. 0* gCumCapturesFrlend. 
gCumCaptureaEnemy, gFirstStone, 
gLastStone}: 


for (i»0: iOEARCH DEPTH: +4i) 
gKillersd] ^ NULL; 
bestScoro - INFINITY: 
pBosiMove ” NULL; 
pSq ^ ChooseNextHoveO ; 
while CpSq) f 

i = GET_IND£X(pSq): 
gSeore - gEfitinAtesfil ; 

score = AddStoneC’INFINITY. bestScore, pSq, _FR1END. 
gStarlDcplh, gCiuiCapturesFriend, 
gCumCapturesEnemy, gFlrstStone. gLastStone); 
gEstimatea (Ij = -1: //scaidi^ 
if (score > bestScore) [ 
bestScore “ score: 
pBestMove « pSq; 

J 


pSq = ChooseNextHoveC): 

I 

if (bestScore “ -INFINITY) I 

for (pSq “ gBoardStart: pSq [= gBoardEnd: ++pSq) 

If (EMPTY(*pSq) U IgEstimares[GET_lNDRX(pSq)]) I 
gSeore = 0; 

score Addstone{ INFINITY* bestScore. pSq, _FRIENU. 

gStarlDeptb, gCumCapturesFriend. 
gCujitCapcuresEnemy, gFlrstStone* gLastStone): 
if (score > bestScore) [ 
bestScore = score: 
pBestKove = pSq: 

1 

1 

if (bestScore “ INFINITY) I 

DebugStr(*^\p no move found Pente"}: 
relutti: //no move 

1 

[ 

♦pBestMove = .FRIEND: 

UPDATE ENDPOINTS (p Be St Wove* gFlfstStooc. gT*astStone3 : 
i = GET_lNDEX(pBestKove3: 
move.h = GrET_X(l): 
move. V = Gi£T_Y £ i): 

‘yourWove = move: 
t+gMoveNum: 

// find captures 

•numCaptures “ MyFindCaptures(cIali»napturea* pBestKove, 
_FRTEND. ^ENEMY): 

gCumCapluresFtleiid •nmnCaptures: 
if (gCuraCapturesFriend >= 5) I 
•claimVictory = true: 

] else t 

•claimVictory = MyFindFlve(pBesrWove, FRIEND): 

I 


TcnnFenrc 

void TerjnPente(void) i \ 


I^ooscNextMove 

short * ChooseNextHove£) 

I 

short i, * pSq: 
short ‘found = NULL; 
short high ^ -INFINITY: 

for (pSq “ gBoardStart; p*Sq != gBoardEtid: +fpSq) I 
i = GET_TNDEX(pSq); 

If {gEstliii.'5tesnl > 0 &L gPreScoteliJ > high) I 
found = pSq: 
high = gFreScore[iJ: 

\ 

I 

return found: 


AddStonc 

//Alpha-beta search raurinc 

// returns score of how gpixl U is for cotor 

// alpha and bcia apply for ihc opponent after the move 

// is made 

// gSaire ts abf«duu::+ for _FRTEND 

short AddStonefshort alpha* short beta, short ‘pSq. 

short color, shori depth, short capturesFtlend* 
short capturesEnemy* short *firstStone* 
short 'lastStone) 

-[ 

register short ‘pNewSq, ‘d: 
short X* bestScore, t, *pErid; 
short open* * killer; 
short threats, blocks* vulnorablet 
sbori opponent - OPPONENl'(color); 
short saveScore “ gSeore; 

START_SAVE; 

threats = blocks = vulnerable - ft; 
d “ gDlrections; 
do 1 

pNewSq “ pSq + 'd; 

if (‘pNewSq = color) f //Ncxi lo friend 
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if (d <= &gDirectlona[3]) I 

^ = 1 ; 

open “ 0: 

for (pNewSq ‘pNewSq = color; pNewSq *<i) 

'Htc: 

if (EMPTYt“pNewSq)3 
open ” 1; 

for (pNewSq “ pSq + Md+4)J ‘pNevSq “ color; 
pHewSq *(4+4)) 

if (EMPTYC^pKewSq)) 

++open; 

] else [ 

t = • CpSq + '[(3 4)); 

if [t ^ color) 
continue: 

X = 1; 

open = 0; 

if (EMPTY(t)) 
open it 

for ipMevSq += *4: 'pNewSq “ color; pNevSq += *d) 
■H-x; 

if (EMPTY fpNewSq)) 

++open: 


swiich (x) { 

case 1: //2-in^mw 

gScore CHAIN_SCORE2[color][open!; 

if [open ^1} 

■H-vulnerable; 

break; 

case 2: //3 in-arn>w 

gScore 1= CHAIW3C0RE3 [colorJ [open]; 
if (open 2) 

Lhreats +“ 2; //tria = 2 

break: 

case 1: //fin-a-row 

gScore CHA1M„SC01(I4[color] [open]; 

threats open • 3: //tessera = 6. haJf^pcn = 3 

break; 

default; // ^rva-mw (or more) 

gSeore +** CHAIN SCORES I color]: 
threaLs 99; //gimeover 

break; 


I else If (*pNevSq opponent) \ //Next to enemy 

X = 1: 

for (pNewSq 4= *d\ *pNewSq — opponent: pMevSq += *d3 
++x: 

if (EMPTY CpNevSq)) t 

blocks ■+- Bl40t;R_SC0RElxl ; 

) else if (x 2 'pNewSq color) t 
t = CAPTURE_SCORE: 
if (color .FRIEND) 
t " t; 
gScore 4* t; 
if (color “ _FRTENtl) ( 

if (4+capturesFriend X** S) ] 
threats = -99: //g^imcovcr 

} 

j else ( //color = _tiNLMY 

if {I*capturesEnemv 5} I 
throats = -99; //game over 
3 

f 

if (depth) ( 

pNewSq “ pSq + *d: 

PUSH_Sa(pNewSq): 

•pNevSq - .EMPTY; 
pNevSq I- *d; 

PUSH SQCpNewSq); 

* pNewSq = EMPTY; 
i 

1 

I 

1 while (HH'd !“ gDirectionsEnd): 

if (threats i 0) f 
// Game over 

bestScore " gScore; 


StoneTable 

You thought it was just a replacement 
for the List Manager ? 

We lied, it is much more ! 


if (color 1= ^FRIEND) 
be&tScote = -bestScore: 
goto RESTORE: 


// No( forced 10 make a bad move 
if (color — .FRIEND) [ 
if [gScore ^ savoScore) 
gSeore = saveScore; 
f else If CgScore > saveScore) 
gScore “ saveScore; 
if (depth) i 
// Aiki Slone 

FUSU_SQ(pSq); 

*pSq " color: 

HPDATE.ENDFOiNTS(pSq. firstStone, lastStone): 

-depth; 

gPreviousThreats “ threats; 
bestScore = -INFINITY; 

// Kilter tTMive? 

killer " gKi11era[depth]: 
if (killec &!» EMPTYCkiller)) [ 
savaScore = gSeore; 

bestScore = AddStone( beta, -alpha< killer, 

opponent I depth* capturesFriend, 
capturesEncitiyt firstStone, lastStone); 
gSoore " saveScore: 
if (bestScore X alpha) ! 
if (heatScore X» beta) t 
bestScore = -bestScore; 
goto RESTORE; 

I 

alpha = bestScore; 
t 

I 

pEnd ^ lastStone + gSE: 
if (pEnd X”" gBoatdEnd) 


Tired of always adding just one more feature to your LDEF or 
table code 7 What do you need in your table ? 

Pictures and Icons and Checkboxes ? 
adjustable columns or rows ? 

Titles for columns or rows ? 

In-line editing of cell text ? 

More than 32K of data ? 

Color and styles 7 
Sorting ? 

More ?? 

How much longer does the list need to be to make it worth 
$200 of your lime ? 

See just how long the list is for StoneTable* 

Make StoneTable part of your toolbox today ! 

Only $200*00 MasterCard & Visa accepted. 

StoneTablet Publishing 
More Info & demo Voice/FAX (503) 287-3424 

http;//www*teleport*com/-stack stack ©teleport.com 
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pEnd " gSodrdEnd - 1; 
pSq = flrBtStone - gSE; 
if (pSq < gBoardStart) 
pSq ” gBoardStart: 
do { 

if (EMPTY("pSq) && pSq J- killer) t 
d = gDirectionsi 
do I 

pNewSq - pSq + ‘di 
if (OCCUPIED!*pNGwSq) && 

t*fpNewSq + “d) = ^pltfevSq l| 

•{pSq - •(!) “ ‘pNevSq)) 

break; 

1 while (-H-d !“ gDirsctionsEnd) j 
if (d I- gDirectloneEnd) I 
savtScote gScore; 

t ” AddStQne{-beta, - alpha♦ pSq, opponent, 
depth. oaptureaPrlend* oapturesEnemy, 
firstStone* lastStone): 
gScore = saveScore; 
if (t > bestScore) t 
bestScore “ t; 
if Ct > alpha} I 
if (t >- beta) { 

gKIllers[depthl = pSq; 
break; 

I 

if (depth >= gStartDepth-l) 
gKitiersIdepthI = pSq; 
alpha - t; 

) 

] 


I 

J while £++pSq <= pEnd): 

if (bestScore INFINITY) I 
^H-depth; 
goto TERMINAL: 

) 

bestScore bestScore: 

I else ( // fdtptli 
TERMINAL: 

bestScore = gScote: 

if (color I- _FRIEND) 
bestScore ^ -bfietScore; 

//Winning ihrcars 

If (gPreviousThreatS >= 5J t 

bestScore THREATS[gPreviousThreatfi]: 

I else if (threats >* 5) I 
bestScore +- THREATSTthreats) : 

I else if (gPreviouBThreata "" 4) ( 
bestScore ■" THREATS{gPreviousThreats]; 

) else if (throats == 4) ( 
bestScore THREATS[threats 1: 

I else if (gPreviouEThreats) I 
bestScore -= THREATS(gPrevioualhreats]; 

I else if (threats) ( 
bestScore THREATS[threats]: 

bestScore 1= blocks - vulnerable ’ VULNERABLE: 


RESTORE: 

while (POP) I 

pSq - (short *)T0P; 
‘pSq “ POP: 

1 

return heRtScore; 


MyFindTjipnirrs 

long HyFindCaptures(Capture capturetl. short *pSq. 

short us, short them) 

( 

short i, 'pi* •p2; 
short EyCaptiares " 0; 
short *d = gDi met Jons r 

do I 

pi = pSq + *d: 


if C*pl = them) j 
p2 - pi + M; 

if (’p^ = them *{p2 + ’d) = us) ( 

‘pi - ‘p2 = _EMPTY: 
i - CET_INDEX(pl}; 

captureImyCaptures].stone1.h ■ GET_X(1): 
capturefmyCaptares]*stonei.V ** GET_Y(1); 
i = GET^INBEX(p2); 

capture[myCaptures],stone2th ” GETJ((i}; 
capture[myCapturesJ*stone2.v * GET_Y(ih 
-Hmy Captures: 

1 

1 

I while (++d f= gDlrectionsEnd); 
return myCaptuces; 


MyfincH'ivc 

Boolean MyFlndFive(short ‘pSq, short color) 

short X* *d. *pNewSq, 1; 

d “ gDirections; 
i - 0; 
do I 
% = 1: 

for (pNewSq = pSq + *d\ 'pNewSq color; pNewSd *d) 
■H-x: 

for (pKewSq “ pSq J *(d+4): ‘pNewSq “= color: 
pNewSq +“ ‘(d+4)) 

-H-x: 

if (x 5) 
return true; 

++d: 

1 while (++i < 4); 
return false: 


I 

I 

-j 

Want to know what products; 
are available for Mac OS ^ 


development? Check put 


T 

■ 1 

.. . 



<http://www.devdepot.coin> 
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Fof Htti'itttftsb 
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Rapid Application Development Tool 


Development Environment 


These products excel in helping developers create Tliese products are high ciiialily developiiieot environments used 
applications quickly, by conventional core dcvcIojK^rs* 


Winner: 

'I 

4th Dimension version 6 ^ 

ACi US <http://www.adus,com> 

Reason for award: ' - 

■* t-.. ■'****. 

lx>Ls of unbelievably positive uslt feedback. *StV6ng 
platform HAD tool, tomie,ss cT(j.s.sfplatfonii iiiterfac<iC I !;; ; ;' 


Description of product: ; ^_ • ■»- • T; ^,;; ;; 

4Th Drn:iensiori;VeT7;km‘*d (4DlV6);iJ,;:^;Mje's 
integrated44al)a:se^^nd-WebJsefvt^TP|^ ireiih 
4D capabilities, the;cpmbined..tlkt4l^?,cjami‘ 

Web enabling 

publish 4K dai|bM<fjron tbe ^ ^” 


Finalist: 

Tools Plus 3.3 

Waters Edge Softwair <http://wwwJnterlogxom/-waterectg/> 

Reason for award: 

Good user feedback. Good learning took Good support. 
Good all around product. 


Finalist: 

Macintosh Common Usp 4.1 

Digitook Inc. <http://www.digitoolxom/> 

Reason for award: 

Strong and positive user feedback. Powerful and rich 
dcvelopmeni tool using dynamic progra mining, multi¬ 
processing, automatic resource allocation, and object oriented 
representation in a manner which is seamless and imuitivc. 


Winner: 


CodeWarrior Professional^ Release 2 . j 

Merrowerks, Inc. <http://www.metrovverksxom> - I 

Reason for aword; :. * •• * 

Strong and positive user feedback, Bxcetleni adxOTfes iii lasf 
year on the product. ^ ^ ^ . . * * " * ‘ ^ 


Description of product: ;; • - 

CodeWarrior is the t^nly Integrated'UevelQphtehtJinyjronR^i^ 

ODR) which enables you td editj com^le^arid 

Java and Pascal prograitii fdr miflripl& EargeC 0(t|L;t5^)rs aaS* 

operating sysrenm ^ xiHiapa^^ prddiTO^ 

highly ^pptiTnized Wndows^^Mf nahnirig 

Mac QS^ ruiming m p£S&sSdir3.;:CodL^^ 

flexibility hi " T T T T f r T." ^ 


Finalist: 

FutureBASIC II 

Siiiz Software, Inc. <http://www.stazsoftware,com/> 

Reoson for award: 

Strong and positive ilsct feedlxick. Professional quality produd, yet 
good learning kx)l iliat confonas to established standauLs. 


Finalisk 

BBEdit 4.5.1 

Rare Bones Software, Inc. <http://www.barEbonesxom/> 

Reason for award: 

Strong and positive user feedback. Powerful and memory- 
efficient application. 
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Tool for New Technologies 


Developer Tool 


These pnxiutls are important to developers on the bleeding 
edge — Rhapsody, Java, etev.. 


Winner: 

CodeWarrior Latitude 

Meirowerks, Inc. <http://www.metrowerk5;{;pm> = • * • 

Reason for award; 

Fills a mtical gap in the Mae to: idiajSsody 
mind, :ls important as iho 68l< the FowerJC 

transition. It allows developers To code 


In itiy: 


native Yellow Box (Le., f!liapspdYlicQd.e at the 
to, not liaving to jiiiove everything, at once; 


pace th(^ WaJitJ 


Description of product; 

CodeWarrior Latitude DR2 

The rewd to Rhapsody starts with CodeWarndr latitude. DonT; 


be left Ixrhind when Rhapsody ships. CodeWarrior Latitude: 
now stippons the first developer^s release of fdKipsady, so' 
you can move your existing Mac OS 7.x or 8.x application to 
Rhapsody and Unix today. CodeWarrior Latitude ivS a software* 
library iliat enables software developers ia create native 
RhapsfXly and Unix applications from existing iMacintosb 
source code. Instead of runiiing your ai)plicaiiun in the blue 
lx)x, Rin it native. 


Finoiist: 

Joy 

AAA+ Sofiwam GmbH, <http://www.aaa-plus.com> 

Reason for award; 

Joy Explorer is an excellent learning toid for Rliatisotly — it 
allows you to look at how applications are built even if they 
aren't yours, joy Developer has a rich heritage from 
OPKNSTFP that is very useful in dynamically creating 
applications very' quickly. Primary weakness is user interface 
which is very Unix like. 


Finalist: 

Visual Cafe for Macintosh 1*0-2 

Symantec Coiporation <http://www.symantecxom> 

Reason for award; 

Rich set of visual tools for Java. Re.st Rapid Application 
Development type environmeoi for Java on ihe Mac‘. 


These prcxlucts should be pan of nearly any developer's repeltyir 
of UX)ls. 


Winner; 

VOODOO 1.8 

UNI SOFTX'ARE PLUS GMBH <Htp://vvwW,uhmft.m 

Reason for award; 

Strong and fxisiljve user feedback .iSplves ^ 

in a very elegant and powerfyl Waly 
with solid imegration with Gt>cleWarrion ”' ^ ‘ ^ 

Description of product: 

VOODOO ^Versions’ Of::Qutdat^l Docuiutmfe-II^Qfe^ 


Orttiogqnally) is the ultimafe version concixjt solutioit^iiitavg 
been waiting for. It fe'a spindalone version contfbi a 

neat graphical user interikee cjffering many 
simple and dear management of projects in which; RlerCTotve 
in minierous versions; - -T/ir;:: : 


Finalist: 

Installer VISE 4-6-1 

MindVision, Inc. <http://www.nnmdvision.com> 

Reason for award: 

Good user feedback. Broad array of com|>anics using the 
[iroduct. Very c^apable prixluct of excellent quality. 


Finalist: 

Spotlight DR2 

Onyx Tedmology, Inc. <http://www.onyx-tech.com> 

Reason for award; 

Strong and pejsitive user feedback. Alkjws users to fmd bugs 
nearly iiiiincdiarcly upon use. Needs interface work, but the 
debugger is very robust and useful. 
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List of 1997 Macworld 
Editors' Choice finalists 
Sponsored by 



Hardware Product of the Year 

Olympus D-600L, Olympus 

Software Product of the Year 

Mac: OS S, Apple Computer 

Technology of the Year 

PowerPC 7S0, IBM and MQton)la 

Cary Lu Technology Leadership Award 

Stylus Photo, Epson 

Best 3-D Graphics Program 

Winner: Electric:!mage Broadcast 2.7.5, Electric Image 
Finalists: Infini-D 4.0, MetaCreations 

Tree Profes^sionai 4.0, Onyx Computing 

Best Art Application 

Winner; Photoshop 4.0,1, Adobe: SystciTis 
Finalists: lliusrrator 7.0.1, AMx: Systems 
Painter 5, MetaCreations 

Best Audio Software 

Winner: FreeSiyfe 2.0, Mark of the Unicorn 
Finolists: Peak 1.63. Bias 

Cubase VST 3-5.2, Stcini>CTg North America 

Best Business Printer 

Winner: magicobr 2 CX, QMS 
Finalists: Phaser 560 , Tektronix 

DcxruPrint C55mp, Xerox 

Best Business Productivity Tool 

Winner: FileMaker Pro 4.0, Claris 
Finalists: ClarisWorks Office, Claris 

Wing7 2.1.1 Invcsiment Intelligence Systenrs Group 

Best Communications Hardware 

Winner: QuickStream Pro, Sonic Systems 
Finalists: YoYo Pro, Big Island Commimit:ations 
Interjet, Whistle Communications 

Best Consumer System 

Winner: PowerCenter Pro 180, Power Ct>mpuling 
Finalists: StarMax 5000/300 , Motorola Computer Group 
SupcTMac C600x/280, Umax Computer 


Best Data-Presentation Tool 

Winner: Data Desk 6.0 Plus, Data Description 
Finalists: ActiveStais LO, Benjamin/Cummings Science 
Numbers ^ Charts L0.2, Adrenaline Software 

Best Digital Camera 

Winner: D-600L, Olympus America 
Finalists: DC210 Zoom Digital Camera, Eastman Kodak 
Digital Ma vica, St my Electronics 

Best Digital-Video Hardware 

Winner: MotoDV, Ratlius 
Finalists: Opiura, Canon USA 
FircMax, ProMax 

Best Dig{tal-Video Unuir 

Winner: Media Cleaner Pro 2.0, Termn Interactive 
Finalists: CineLfx>k, DigiEffects 

Studio Effet:ts, MetaCreations 

Best Display 

Winner: MultiSyn(: LCD2Q00, NEC Technologies 
Finalists: Diamond Pro 91TXM, Mitsubishi 
Multisc^n 200sf, .Sony Eleclrrmics 
Optiquest V773i ViewSonic 

Best Game 

Winner: Mytin The Fallen Ix^rds, Bungie Software 
Finalists: Quake, MacSoft 

Riven, Red Orb Entertainment 

Best Gaming Hardware 

Winner: F-16 Fighiei-stick, CU Products 
Finalists: Pro 7'hrottle, CH Prcxlut:Ls 
Power3D, Tec:tiWorks 

Best General-Purpose System 

Winner: Power Macintfwti G3/233 Desktop, Apple Computer 
Finalists: !\)werB<K)k 2400, Apple Computer 

PowerCenter Pro 210, Power Cfimputing 

Best Graphics Plug-In 

Winner: Genuine Fuictals, Altamira Group 
Finalists: Eye Candy 3.0, Alien Skin Software 
PhoToT<K>l.s 2.0, Exlcnsis 

Best Input Device 

Winner: LlltraSlate, CalComp 
Finalists: Orl>ii, Kensington Micro ware 
Pl-300, Wacom 

Best Internet-Cuent Software 

Winner; Emailer 2.0, Claris 

Finolisis: NetFinder 1.2.1, Peier Li ik. Vincent Tan 

PGP for Personal Privacy Ven 5.0, Pretty Gcxxl Privacy 
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Best iNnRNEX-SERvcR Software 

Winner: WdxSiiir 2:1, Quarterdeck 
Finalises: Lasso 2,0, Blue World Communioiions 
Rumpus 1.1, Maxum Developmeni 

Best Multimedia-Authoring Software 

Winner: Direaor 6 Multimedia Studio* Macromedia 
Finalists: QuickTime VR Authoring Studio, Apple Computer 
Authorwarc 4.0.1, Macromedia 

Best Networking Software 

Winner: CyberGaugc 2.0, Neon Software 
Finalists: PC MacLAN 6*2, Miramar Systems 
SoftRouter 4,0, Vicom Technology 

Best Personal Printer 

Winner: Stylus Color 800, Epson America 
Finalists: Color StyleWriter 6500, Apple Comj^juter 
Stylus Phouj, Epson America 

Best Professional System 

Winner: SuperMac S900 Base with Umax Edition 
Maxpowr Pro+, Umax Compiitcr 
Finalists: Macintosh PowerBtxik G3, Apple Compuicr 
l\>werTowLT Pro 250, l^ower Computing 

Best PROJEaoR 

Winner; PowerLite 5000, Hp.stin America 
Finalists: LiiePro 720, In Focus 

ProscTeen 46(K) Eniliirancc, Idnlips Flecirf>nic5 

Best Pubushing Tool 

Winner: QuarkXPress 4.0, Quark 
Finalist: Acrobat Pro 3.0!, Adobe Systems 

Best Pubushing Utility 

Winner: Preflight Pro LO. Extensis 
Finalists: Font Reserve LO, DiainondSoft 
QX'Ftx)ls 2.0, Extensis 

Best Scanner 

Winner: Expression 636 l^rofessional, Epson America 
Finalists: PowerLook ll, IJjnax Technologies 
Aslni 600S, Umax 'reciinologies 

Best Science/Engineering Tool 

Winner: Mailiemafio 3-0.1, Wolfram Research 
Finalists: MicroStation 9^, Ikniley Systems 
MiniCAD 7.0.1, Diehl Graplisofl 

Best Utiuty 

Winner: Conilict Catcher 4.03, Casady & Greene 
Finalists: Speed Doubler 8, Connectix 

Viiex witJi Speedsc'an 5.8, Dr Solomon^s Software 


Best Web Authoring Tool 

Winner: CyberStudio 2.01, Golive Systems 
Finalists: Flash 2, Macromedia 

PageSpinncr 2.0.1, Optima .System 


World Class Awards 

Impact Awards 

One you know, the other you probably don't. But Apple 
interim CEO Steve Jobs and former Power Computing 
marketing manager Mike Roseiifelt both made a big difference 
in tile Mac market. 

Steve Jobs took Apple's reins in July and quickly made 
his mark on the company he co-founded. He reworked the 
board of directors, Forged a controversial deal with Microsoft* 
and gave a new sense of direction to what had been a 
rudderless enterprise. But lie also killed Apple's Mac 08 
licensing program, and by cutting out the clone vendors, he 
cut off a prime source of innovation in the Mac market. 
Whether you agree or disagree with his move.s, he has clearly- 
had an impact. While Macworld believes it is uk> soon to say 
whether Jobs will ultimately be good for Apple, we can't deny 
his impact on the Mac this past year. 

Mike Rosenfelt never made the cover of -Time* or 
-Newsw'eek*, bur the guerrilla marketing techniques he brought 
to Power Computing helped re-energize the Mac community in 
a way wc haven't seen since a pirate flag flew above Apple's 
Cupertino headquarters many years ago. 

He was the man behind the bullhorn at Power 
Computings MacwoHd Expo pep rallies and the brains 
behind such memorable stunts as biingie jumping platforms 
in Boston anci a fleet of Mac* promo ting huinvees in San 
Francisco. At a lime when Apple seemed never to have its act 
together, Rosenfelt and Power Computing in.sptred us all to 
fight back for the Mac. 

UfETiME Achievement Award 

Richard ^ulch is one of the unsung heroes in Macintexsh 
Itistory. He's the co-founder, chief technoiogy officer, and vice 
president of engineering for Dantz Development, the company 
that gave us Retrospect. But liis contributions to the Mac go far 
beyond back-up utility software. 

Working as a pro bonti consultant for Apple, Zolch 
played a key lu^hindthe’scencs role in developing neariy 
every major stonige driver for the Macintosh* You may take it 
for granted that your Mac works with hard drives from 
companies other than Apple; it was Ric:hard Zulch who 
helped make it happen. Zulch was also a driving force behind 
nF8-f-, the new file system introduced with Mac OS 8T, that 
lets you use your hard disk more efficiently* None of his w^ork 
liad a direct financial benefit for Dantz: instead, he gave 
freely of his rime so that MaOntosh users could have a better 
computing experience. His lias truly been a lifetime of 
achievement on behalf of the Mac. 
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by Jessica CouHney 


St\lker Softwarf Aninouncfs CoMMLiNiGATE Pro Sfkv™ 
Aficr liic successful launch of The Stalker Internet Mail Server, 
Stalker Software announceii the CommuniGate Pm tness^tging 
server for the Rhapsody family cjf operating environments. 

'rite new reincarnation of the ComimmiGate integratcxi 
messaging system unifies the performance and stantiarcl- 
ccaitpliance of the SIMS with flexibiliiy and jx>werful feaaims of 
the mcxiular iVIat:OS QimniuniGate System, 

The CommuniGate Fro Ls Itased cm the R!iaps<tdy Foundation 
framework and can nm under all ttperating systems suppoited 
with the Uhap.scxly '‘Yellow-lxrx*** Rliapsody for Power Macintosh, 
Rhap^sody for Intel, and the Yellow Box for Windows NT. 

The CommuniGate Pro design empkjys many modern OS 
tei'hniqut^i espec:ially muld-tltreading. Unlike otlier serv'ers that u.se 
one .sc^paraic tJiread to prcKess a message, messages in die 
CoinniuniGate Pro are processed with 4-6 thmads on tlieir fxiths to 
destinatioas. For high-volume sites, such as major ISPs, this me:ins 
a huge perfonmnee lx.‘nefi£, especially for multi-paKX"s.sor sennets, 
Tlic CxxnniuniGate Pro server is completely SMP (symmetric 
multiprocessing) ready. Hit? SM'FI^ cx)tTifK>ncnt of the CommuniGate 
Pro server inc’orpcjnaes all Lite atni-spamming features impiemeored 
in the ComttiuniGatc SMTl^ and Stalker Internet Mail St^rver. 
<http://www,stalker,com>. 


LiGin Work Design iNTROOircES Family' of 
DgietWorks Rendfrincs and Umn'Y' Plug-ins for 
QLiit:id>RAW 3D 

LightWork Design, the leading supplier of rendering 
engines for 3D design applications, is introducing its new 
family of LigluWorks rendering and utility plug-ins For 
QuickDraw- 3D at the MAC^lWORLD Expo, Apple Developer 
CenLrah in fian Francisco, January 6-9- The six new 
Light Works piug-ins offer a w'ide range of features, including 
ray-tracing, hidden-iine drawing, printing and QuickTime VR 
movie output. 

The Light Works plug-ins are available to QuickDraw' 3D 
application developers for inclusion as pan of their prochicts. 
With llie plug-ins, developers can offer their customers a 
range of new' functionality wiihoul the time and expense of 
in'hou.se development. 

QuickDraw 3D application developers can chcKxse from 
ixnh rendering and utility plug-ins: All six LigluWorks plug-ins 
for QuickDraw^ 3D are siippoiied on Macintosh, Windows 95 and 
Window's NT systems. 

<http://www,lightwQrkxom>. 
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TCP/IP Scripting Addition The Internet Scripting Solution 


The TCP/IP Scripting Addition allows you to quickly 
develop Internet client/server applications using 
AppleScript®. If you want to script with MacTCP^'* and 
Open T^ansI>o^t^^ here's your solutionl 

♦ Supports WebSTAR^**, FaceSpan"™, and HyperCard^® 

♦ T ho i n d ustry s l a n d a rd p rod u c l for sc ri p t i n g 
Inlernel applications since 1993 

♦ Sample scripts include FTP, HTTP, 

Telnet, Post Office, E-Mail and more 

♦ Fealured on the Apple® Internet Server 

Order now through Developer Depot at 
SOO-MACDEV-I or other mail order stores 


w 


Mango Tree Software, Inc* 

Box 1057 • BrooMinei Massachusetts USA 02146 

Fax / Voice 617«327-^66 J 

saie5«tna riuo4rce.com • www.mangottee.com 


All irademarks are properties of their respective holders. 

Contact Mango Tree Software for site licensing and redistribution Information . 
Copyright ® T 993-0 Mango Tree Software, tnc. 


FTP Parameters 


I 



Set these paran 
(sending) files ^ 


FTP Host 
Directory 


Telnet Libre 


Vi 


User ID 
Passvord 




Type of file tr® 

O MacBinary File 


'W Description 


Telnet Library vl.O 

Copyright © 1995 Mango Tree 
All Rights Reserved 




Riefccrd Stop Run 


set mg_telnet_3tream to telrw 
tell my_telnet^tream 

try 

connect(your_ho3t) 
read u nti 1 text( "1 oc 
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The 13**^ Annual Conference for 
Leading Edge Developers 

MacHack papers are the comerstone of the premiere Madntosfi technical 
conference. Papers cover a wide variety of cck>1 topics. Anything from 
Adaptive Compiiring, the Business of Macintosh Development, Game Design, 
and Internet jirogramming, to Rhapsody, Debugging, the Programming 
Subculmre, Virtual Reality, and Mac 08 iniemals and hacks. 

Would you like to astound and amaze your peers and also get a free conference 
registration? If so, then share your in-depih knowledge of a let'hnique, 
technology, philosophical point, or some odier arcane knowledge and wriie a 
j)aper for MacHack ’98! 


Point your favorite email program to niacliack-papcrs@iiiachack.com and send us your idea, abstract, questions, 
or other secrets. Abstracts are required by February 15, 199K 


Attendance is limited — register early. ■ 

Bound proceedings & Best Hack CD will ixi dislriliuled lo all atiendees. I MacHaclc ^98 

I June, 1998 

For more information or to register; I Dearborn, Michigan 

Expotcch, 1264 Bedford Rd., Grosse Pointe Park, Ml 48231)'1 116 I 

313-882-1824, cxpotech@aoLcuni. http://www.machaek.com/ 


Is & irademark of Apple Compuier. AH oiners to theJr respecrive holdefs MacHack is a iraciorricirK of Expoiech, Inc Nol affiliated with the MacHax Group ". 


wn^ijAirs 




Siatemant of Ownership. Managomcrtt. and Cfrcitlatton 

1 *4.1^ [Mi 




_ 1 nt a 

/[piJzOZIMo^^_ 








,_^_. I’h 

i Cti pi n7 i4i4ii^fc toi i i i pmapm? 


^l2ioa 


iAlLu^,^4 


Aki T.cM.. jV«. Oul^, f'3t/ 

Mwr fltmmi rntrcrn^mw H H >i i .ii M pii !j 

f r t CiimJ I AO'- p -"w ^ W , C/i Vni / 




«1*|M V 


•r* m m> ■ nff iiit— ww —— 

-==-:=- 

y^U.,n CcrytAruifttn^ 

is7y-/!> LLytL.. Of utuiUL i/tfas,;. 


'Kdrt^L. 8riA^iyyu^ 

its/ WLt^/.A fnt.1 

AJ 


jrn-/» iffii 


r 






•i« 1 rwM Mm iritMM 


r I« I Hh. □ tit« W ^ 


























































































































hy Nicholas C. 'irick.c'' DeMello <on!me@mactechxoni> 


WilAT IS TCP/IP? 

Wlicn Pau! Baron first tlevelopecl the concept that became 
today’s Internet, he was iry'mg to solve a military pn>blem, Hus 
\%4 proposal described a etjiniiiunications network that had no 
central auliioriiy and could adapt to imssive iailures — therefore 
one that could not be easily disabled by enemy bombardment. 
Baron’s solution was to t>reak coniiiiunieations down into small 
pieces, eacli labeled vvidi the address of a remote computer. 
These “packets” of information would then l>e passed through an 
intricate network ()f computers — like pails in a rirefighref.s 
Inicket brigade. If a telephone line or fire hexse is cut, the flow' is 
interrupted, but if someone steps out of line in a bucket brigade 
or a coiTipiirer goe.s offline, tbe system can pass it's cargo around 
the disruption. The more intricate tile web of computer 
connections available in the network, the more reliable 
coniniunication became. This packet ba.sed communications 
concept and the mechanisms for transferring f^ackcLs along a 
nctw'ork is the basis !br the internet protcKoI — IR 

Vinton Cerf was a graduate student at liCLA in 1969, wiien 
he helped put the first computer on the inlerncL As more and 
more machines wore added to the internet, standards needed 
to be developed for translating data from a system level into a 
foimar that could he transferred hy the internet proiocoL Tiie 
InerNetworking Working Croup (INWG) was founded in 1972 
U) develop these standards, with Vinton Cerf as the chaimian. 
Two years later, Vint Cerf and Bob Kahn published “A Protocol 
for Packet Netw^ork Internetworking" which specified a 
slantlard protocol for converting a stream of data into a series 
of packets, for reassembling the packets into a stream of data, 
requesting lost packets be resent, and basically controlling 
communi<'ati<)n through Baron’s inicrnei pnHocol. First titled 
the netw^ork control protocol (NCP), it was later renamed the 
transmission control protocol — TCP. 

What kind of computer do these visionaries and founders of 
the inforinaticjn age use today? According to the MacAddict a 
1996 television interview' with Paul Baron showed him at his 
computer — a Power Mac 7100. During an interview for the 
Netinsider, Vint Cerf was asked what kind of computer he uses 
today. His response was an emphatic; ’Tm a Mac FreakP 

A Short History of the Internet by Bruce Sterling 

<http;y/www. ubicom xom/'h istory. h tm l> 

The Internet Valley, History of the Internet by Gregory R. Gromov 
<http: //WWW. En temetvalleyxom/intvai .html> 

Introduction to TCP/IP by H. Gilbert 
<http ://pdt. cis.ya I e. ed \ii pc I t/com m /tepip. htm> 

RFC 1130: A TCP/IP Tutorial 
<ftp://dsJnternic.net/rfc/rfc11 S0.txt> 

Paul Baron Appears on the Evangelist List of Famous Mac Users 
< h ttp://WWW. e van gel ist. maca dd i ct.cD m/ad voca cy_3Ction. h tm I > 

Interview with Viot Cerf, Internet Founder and "Mac Freak" 

< hup: //WWW. nebrtsid er. com/prof Ele/veerf/prof lie/ > 


Using TCP/IP on a Mac 

TCP/fP is accessed through Af)ple’s Open Tmns(x>ri system. 
When you review the OT technology' on Af^ple’s web site (or in 
Inside Macintosh: Open T’rarLSport) yoti sliould realize that OT was 
design eel lo supp()rt tran.spoit indLqx:ndent code ™ your code u.se 
data streams to send information witliout knowing wfiat kind of 
network the u.ser is on (ICP/IP, AppleTalk, or other). Open 
'Tnmspoit dcx.*s allow^ you to design transport specinc applicatitjns 
thouglu and c'speeialiy with TCP/IF this may Ix^ desirable. Hie 
place to stait for TCF/IP specific development is with Apple’s 
OpenTraasport/fCF dev note, which t:an lx found on the same 
FTP site as ihe OT .SDK, Also visit Mark S]>rc>urs Open TiansjKiit 
Development web pages and Eric Scoiiten’s xMacintosh TCP/IP 
Programmer's Guide on the metrowerks web site. 

John Nofstad has made the Newswatcher source ctxlc pui)lidy 
av;dlal)le. This cxiremcly |xjpular freeware USENET newsreader Is 
cx>mpatiiile with MaeTCP and OpcjiThinsixart, its source is probably 
the single most valuable a^fercnte a Mac TCP/lP pitjgnimmer on 
find. l/x)k espxx’ially closely at tlic ft[>.c, niitp.c, smtp.c, and net.c 
stKjRcs, Tlie.se I ties are leusable, mtxiular C ccxle for implementing 
some of the most jxipLilar T CP/IP applications. Also chec:k out Peter 
N lewi.s' T'CI^Example ccxle and liis P>JL TCP/IP lit>raries for 
itri|)lementing TCP/IP. Tliis Ptiscal ccxle is llie foundation Peter's 
tremendously sucxessfiil T'CP/TP shareware produces An^irchie and 
Netl^resenz. Peter has developed Stneamwatcher, a debugging L(x)l 
that allows you 10 examine data in an Open Transixirt TCP stream. 
Once you liavc Strcamwatcher, check exit Mark Mentovai’s Mac on 
tlie Net web site for other TCP/fP diagncjstic utilities like Bryan 
Christians<.>n"s IP packet rontelracrer WhaiRoute 1.4.3. 

Apple's QpenTransport Website 

<h itp://WWW. devworld.a pple. com/dev/opentrans port/ > 

Inside Macintosh, Open Transport and OT 1.2 Updates 
<http://gem ma. app le.com /Tech i n fo/tcc li d 0 cs/m ac/ m ac. him l> 

Open Transport/TCP Dev Notes & the OT SDK 
<ftp://seedi ng .a p p I c.co m/oss/py bl i c/opc n t Id n spoa/> 

The OpenTransport Mailing List, Hosted by Stairways Shareware 
<http://www.sta I rways. com/mailinglisls/opentpt. htm l> 

Open Transport Development Pages by Mark Sproul 
<http ://msprou] .mtgers.edu/ macintosh/O pen 1 pl_Dev. him t> 

Macintosh TCP/tP Programmer's Guide, by Eric Scouten 
<http:// WWW. metro we rks.com/tcpi p/> 

John Norstad's Newswatcher Code 
< ftp ://fl p. acns.nwu.edij/pii b/Rewswatcher/> 

TCPExample & PNL TCP/IP Libraries by Peter N Lewis 
<ftp:// WWW, stairways.com /sta Erways/sou rce/> 

Mac TCP Watcher 2.0 and Streamwatcher 1.0 by Peter N Lewis 
<htrp://ww w, stai rways.com/mt(;pw/> 

<http://www.sta] rways, com/strea m watch er/> 

Mac On The Net Archive (inch WhatRoute and other TCP/IP Diagnostic Utils) 

<http://www,moxienet.com/macnet/> 

T'hese and other links ure jtrehived on ihc Muc.Tet:h Online 
web pages ut <hitp://www.mactech.com/online/>, Mi 


Fl'Bhuaiiy 1998 • MacTkcii 


Uneform Kesourcf. IjOCATOHS 


61 









TIPS & 
TIDBITS 


hy Steve Stsak 



Logigu Names 

Unfortunately, the Macintosh doesn't have a system-level 
mechanism for dealing with the notion of logical iraths. Aliases 
don't work when files gel moved, and using paths with device 
names doesn’t work because everybody uses different device 
names {besides, device frames aren't guaranteed to be unique)- 

As a kluge for NfPW Shell, AppleScript and Madntash Common 
Lisp, we create a folder in the system folder called “Logical Names'' 
and place aliases to other files and folders in this folder. Tiic name 
of each alias is tlicn defined, in some application specific way (q.v, 
l:)elow), as a symbol bound to the file found by resolving the alias. 
ITiis allows us to put aliases like “ProjFolder” <jr “Moaf ilesFoldcr'’ 
in the logical names folder and have a chance ctf l^ing able to use 
l)uiid scrij>ts. Makefiles, etc. on other folks' machines without having 
to do a major re-write of the fdes in question- 

Usage 

To make use of any of the specific implementations 
described l>elow, you need first create ytjur logical names folder 
This folder must inmiediately in your system folder, and it 
must be named “Logical Names" (note the space). 

llien, create some usehil aliases in this folder For example, 
we typically place the following in our logical names folders: 

TempFalder - an aliaa to the RAM Dii^k 

HomeFolder ^ an alias to tRe folder containirtg folders 

ProjFolder ‘ an alias to the folder containina project folders 
ArchlvesFolder - an alias to the folder containing archives 
TransferFolder - an allae to a folder used as transient storage 

You may place aliases within folders witliin the logical names 
folder, though you should avoid name conflicLs l>elwecn folders. 

iMPW Shell 

'Ihis implementation is distribuied in tlie file: 
LlserStan up * ILogicalNumes 

For the MPW Shell implementation of Logical Names, we 
use a start-up sa1pt to create an environment variable for each 
alias in the U>gic:al names folder The name of each variable is the 
same as tlie name of the alias. The value of each variable is the 
resolution of the alias. In addition, the LogicalNames variable is 
set To a list of the installed logical names. 

To make use of lliis .script, simply place it in your MPW 
folder (leaving it named *'UserStanup*!LogicalNanies“). 

For example, If you've created the “ArchivesFolder" logical 
name alias, once you launch MPW die following sliould report 
the full path to your archives folder: 

echo tArchlvepFoIderj 

AppleScript 

This implementation is distributed in the file: LogicalNamesas, 

For the AppleScript implementadrin of fxigk^ilNames, we use a 
flincikm ii} kx>kup and resolve a logical name tilias given its natnc, For 


this implementarion only, if the alias is In a sulvfolder of die logical 
names folder, tlicn a partial path must l>e supplied LogicalNames as also 
supplies a utility^ function which conveits an item inio a full path string. 

To make use of these hi net ions, you must fksl load and 
compile LogicalNames.as using the Script Editor. Tlien, you must 
save the compiled script as a Compiled Script to the file 
“logicalNames" in your Scripting Additions folder. Now ids in a 
well-known kxation. Then, insert the following at the lieginning 
of every script in wliich you want to use logical names: 

tell application “Findej:'' 
set LogicalNatses to ^ 

(load script file 

(nanie of startup disk &":**&-* 
name of systc^m folder &*:**&“■ 

'^Extensions: Scripting Additions; Logical Names")) 

end tell 

Tliis will bind the Lc^icalNames vjmble to the (pievkxisly savexi) 
ccNiipilation of the [ogicalNames.as script, from wlucJi you may use the 
IcgknlNameCieillemCaNaiTK:) and fullPatliFromItem(anItem) functions. 

For example, if you've created the “ArchivesFolder” logical 
name alkis, a script such as the following should repoit the full 
path to your iirc:hive.s folder: 

tell application "B'lnder** 
sat LDglcslNamog to ^ 

(load script file ^ 

(naJie of startup disk k ":** ^ ' 
riawe of systeira folder & k 
"ExtenslonsiScriptJog AdditlonsiLogicalHames")) 

end tell 

set myArc to logicalliaaeCetXtenit^ArchivesFolder") of T-oglcalKainGS 

fullPathfromltefli(iByArc) of LogicalNames 

Macintosh Common lisp 

'IhLs implementation is distributed in the file: logical-names.lisp 
MCI. has a concept .similar to logical names in its io^cal hosts\ 
but no reiLsonable built-in meclianisnis for defining them in terms of 
the generaliml Mac file system. vSo, for the MCI impiemcniaiiijn of 
Logical Names, we simply provide functions for defining a logical 
Ikxsi for cacfi alias in the logical names folder, Ihe mtme of each 
logical host is the same as the name of the alias. 'Ihe target of eac:h 
logical host Ls the resolution of the alias. 

To make use of Uicsc‘ funciicjns, simply ]>lact^ lpgital-names.lisp in 
your MCI folder, tiien add die following to your init.lisp (or .f^.pfef) file: 

(laad “log!cal-names.lisp**) 

(define-all -logical nanefi) 

For example, if you've created the ^'ArchivesFolder'’ logical 
name alias, once you launch MCL the folkrwing should report the 
full paih to your archives ftdder: 

(full palbname (make-pathname fnoBt "AcchivesFolder")) 

Mika Webb <mji4JWi:odeuelLcom> md 
JeffMalkm <}}mWcodeimllc{m> 
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The Law Office of Bradley M. Sniderman 

California Lawyer focusing on Inteltectual Property, 
Corporate, Commercial and Contract law, as well as 
Wills and Trusts. 

If you are looking to protect your software with 
Copyright or Trademark protection, or if you need help 
establishing or maintaining your business, please give 
me a call or an e-maiL Reasonable fees. 

(310) 553-4054 
Brad@Sniderman.com 


Visit MacTech* Magazine’s Web site! 

http://www.mactech.conn 



Professional software developers 

looking for career opportunities 
should check out our web site. We 
offer nationwide employment assis¬ 
tance, resume help, marketability 
assessment, and never a fee to the 
applicant. 800-231-5920, Fax 800- 
757-9003 eMail:das@scientific.com 




Scientific 
Placement, Inc. 




move? 


Depot! 


The fastest/ cost effective way to get product off your shelves. 

For information: • Voice: 805/494-9797 • Fax: 805/494-9798 • E-mai!: marketmg@devdepot.com 
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To Do List: 

• -■ list & generate sehe 

'idacTeeh CD-ROM v. 1-1 

Qepet specioU 

1 about Dev Depot dealt 
the latest books & udlW 
info into contact fiM 


D©veloper 

[^Prioriti*o pro|ect 

r~l Pick up now T— 

□ Check out all the Dev 

□ Tell the gang 

□ Stock up on t 

□ Enter Dev Depot 

Developer Depot 

PO Box 5200 
Westlake Village, CA 

Voice; 800/MACD^-1 
Outside US/Canodo. 805 
Fax; 805/494-9798 
E-mail; o'f***'^*®^ 

,devdepot.ee 


http://www. 





















by Eric Simend 


And then SOM... 


IbM System Oh/ecl Model (SOM), which 
am mtroduced on Mac OS with (.^milJoc, 
has iK^comc eimi mare tmfKirtani to 
detMdojMtrs iiiib the ininiduclion of the 
Cbnlexluai Mentis in Mac OS H. It's not 
restncled to the deiKdopment of Contextual 
Metins ins, Iboti^^h. SOM is also 
available to all demhpets and soloes d lot of 
common issues which blague real-life 
jwoject develofmumt, nutnu^emenl and 
mainttnmnee. Ihis artkie will show bow 
SOM cun ease )mr prodtfct deieloptnenl 
and saife yon rprecious time. 


Since nicxst clevelopers develop in C++ 
f>r other ohject-orienit^d lan]tfis:i^es these 
d:jys, most ot you know die obvious 
rcast)iis why object-oriented programming 
is bener tlinn the previous motlels. The 
main strengths (w'hiL'h are also its 
definitions) of OOP are enopsulation, 
polymorphism, and inheritance, all of 
which are conclucive tf> easy reuse. 

Tliai’s tlieory. In real life, we deal with 
different devekpment environments which, 
even when they’re dealing with the same 
language, are not always compatible 
because of implementation choices, and are 
usually even less compattble wiien dealing 
wiili dilTereni languages. Even wdien staying 
widi the same development environment, it 
change.s over time, and it’s alw^ays trouble 
to reiniegiuEe old code in tiew' projecis, and 
sometimes, it’s even trouble trying to 
reopen an old project for maintenance with 
a t:urreni development envininmenh 


So, a usual projeci these days involves many developers 
who have different tastes in development environments and 
languages, old legacy source codes written in different languages 
under different development environments, and sometimes old 
legacy binary ccxle.s whose source codes are no longer available. 

Although SOM is not the universal cure to these problems, 
it does bring a lot of relief, and even if you’re a single developer 
using only one language, SOM am help yon manage your pnjjccL 
by breaking it into small easily reusable pieces. 

Geh ING SOM 

SOM provides develofiers witli the advantages of boili 
olijeci-orienied f)rograniming and shared libraries. The main 
advantage is that whether you’re just using a SC')M class from a 
library or inheriting from it, if you later replac:e tliis library with 
a more receni vuixion, you don’t have to recompiJe or rebuild all 
the client code. When you stop and think about it, this feat is a 
real breakthrotigh from w'hat w'eVe been dealing with until now. 
Hie s^^c'ond advaniage is ,SOM's language independence, which 
allows developers to use their favorite environment and still 
mesh with other people’s axle. Due to its rather recent 
emergence in the Mac OS, the [xcrerrc'd (and only) language 
used with SOM is C++, but it may change in the future, 

Tliis article will cover the basici: of SOM encapsulation, 
polymorphism, and inheriiance, the use of a SOM library in an 
application, and in another SOM library, multiple aspects of 
versioning, dealing with exceptions, etcetera. This article Is 
aimed at giving you a kic'k start, covering the l>asics aspects of 
SOM and how to use it for fun and profit; it will explain in some 
places the internal works, in case you’re interested, but not 
everywhere. If yoiiYt* inten?sted in more kncjwledge about SOxM 
and its internals, then you should read the manuals provided 
vviiere SOMObjects^'^ for Mac OS is distributed (for example, on 
the Mac OS SDK CD). This knowledge is not an absolute need, 
mostly you can just program l>y example (and a lot of examples 


Eric Simenel is really happy he transferred to Cupertino’s DTS from Paris’ DTS. Aside from the fact tliai he 
received a great welcome from liis current colleagues, he’s getting much more sun here than there. And, due to 
his constimt location here, he has easier access to comic books conventions, so he has completed many runs: the 
current mark is at 23,000 and counting. 
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arc provided in this article). An alterniite title for this article ctnjkl 
have l^en “SOM for C++ developers*./. When 1 refer in this 
article to the Users Guide, il rne:tns I lie Users Guide found in the 
dot'll me mat ion folder i)f SOMObjects. 

Throughout tliis article, I'll use tlie following exampk? to 
illustrate the difUerent technk|ues: 



Where sorti_Taxcs (enctipsHiation) is a SOM class used by 
som_Item (fisa^e of a SOM Uh within a SOM lib). soiTi_Solid 
{inheritance) and s<im_C"arWasli {Meta Chtsses^) both inlierit 
from somjlcin. S()ni_Car {exception handUng) inherits from 
soni_Solid, soni_T!res {muUiple inheritance) mulriple inherits 
from som_Solici and som^Aur, and som_Tapes iversionning) 
inherits fn>rri som_Solid l>uL does interesting things when 
soinjtcm V 1.1 is present. 

F.ach class Ls there to illustrate one intea^siing jxiinl at a time 
(to prevent t'tjnfusitrn of t!ie Issue's). To understand the example, 
you sluHild note that I have assumed that wc'ie loc^iied in a country 
where prcxlucts are submitted to sales tax l>ut services are not. 

Tve been using ifie Direct-To-SOM capabilities of 
MetroWerks GxleWarrior MW C/C++ (CodeWarrior Pro release)* 
I verified that MPW MrCpp also has the same capabiliLies, but I 
don't cover its usage in this article. I al.so verified that you can 
[mild (>8K SOM libraries, l>ul do not cover that in this article 
either as tliere are only minor differences in the projeci settings. 

Throughout this article, all the listings have been purged of 
irrelevant (for this article) lines, such as debugging information, 
to hilite the more interesting parts. Look at the real code 
provided with this article to see the complete sources. 

ENCAPSOUVriON 

l.et's say that you have old legacy source or binary code* 
Fach time you want to use it in a new project it may be a pain 
to integrate, because things change over time. If it’s binary ctxlc, 
it may 68K (xxie, for which you have to construct 


UniversalPrtKTlrs* If it's source code, it may I'le in a different 
language than the one you’re currently using, tairrently, if that 
ccxle is callable from C/C++, then you can entapsulalc il in 1 or 
more SOM c'l:i.sses rlisrrihuted in 1 or more SOM shared libraries* 
In my example, lliat would lie the somjl'axes SOM cla.ss* 

The mil in advantage of encapsulation in a SOM wrapjxT Ls 
to enable you to use this okl legacy ctxle in all your new' 
projecLs, with a nice interface. And, eventually, if you decide to 
rewrite all or part of it, all the projects which havt' bexm using 
this code won’t have to Ix" rebuih lo continue to work. The SOM 
wrapper really isolates the interface from the implementation. 
Wliereas, if you were to keep thi.s code the way it is, with maylK' 
just a nice new *set of headers lo !>e al>k' lo use it easily in new 
project*s, and if you decide later to nuxIilV all oj‘ part of il, then 
you would have to rebuild ever>ihing. 

Ilie costs involved are not only a devekipment issue but 
also a salt.'*s issue, in the first case, since w'eTe tlealing with 
shared lif>raric*s, you just have tt) ship your customers the new 
version of the SOM library containing the okl legacy c:<xle, now' 
updated. In the second case, after having rel>uild everylliing, you 
[lave 10 slii]) everytliing. 

Creating a SOM librar)^ Ls pretty straightforward. Witiiout the 
Direct- Tfi-SOM opabilities of the most rtco! C++ compilers, we 
would have had to write first an *idl file, tlien go through MPW 
somipc to generate the *xh, *xlh and *cpp files, and then modify 
the *cpp file according to w-hat liad ttj be done. With the Direct- 
TckSOM capabilities, it's much quicker we simply write a .hh 
1 leader file (.hli is just a style crinvention to differentiate them 
from .simple .h header files, hm there atv no other differences) 
and the c:orresponding *cpp file. As a reminders a kxik 

at the .id! we would have written for straight SOM: 


listing i 
soni_Taxes.idl 

tflticiude < somob j . ldl> 

module CaicTaxes 

I 

Interface som^Taxes : SOMObject 

I 

1t)n£ CalrTtieTax(lji long value, in short kind) i 
#ii:def _soMir)L„ 

impltimenLalltin 

t 

ma jotvBraion = 1; 
minotvarsion ^ D: 
fuudtlonpreiix ^ so»_Taxes_r 
override: soinliiit: 
rclFianRorder: CalcThsTax: 
long Lax: 

1: 

Ifendit //_SOMIOL_ 

I: 

I: 
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Compare this with the *hh we are wriimg for Direei-To- 
SOM compilaLion; 


Listin}* 2 
d2som Taj^s.hh 

fflnclude ^fioniobj *hb^ 

i:l4ijss CalcTaxt!^_sonijraxes ; public victual SOMObjuct I 
public: 

Cal cTaxe a fiom TaxtisO; 
virtual ^alcTaxR'3_sDiii_Taxest) J 

virtual long CalcTheTaxlTTOJT Snvitoniaejnt ‘ev, IN 
long value. TK abort kind): 
private; 

long fTax: 

#lf _SOM_liNAJiLKD_ 

iptagma SOMeleaseOrder (CalcTheTax) 

#pragBia SOMClaseVecslon {CHlcTaxen_uoin_Tcixus, 1* 0) 
^pragma SONCaliStyle IDL 
il^endif 
I: 


Comparing both .idl and .hli, die iiieaning of the 
SOMReieaseOrder and SOMCI ass Version pragmas are jircUy mut:[j 
obvious. The SOMCallStyie pragma can take 2 arguments, IDL 
and OIDL. If we want to u.se the excepiion.s mechanism (more 
on that later in this artkie), it is imperative we use the IDL 
argument, so ids a gtHnl idea to get into this habit. This means 
that each niethtxJ must iiave Environment *ev as its first parameter. 

The first difference lx*iween a SOM cltiss anil a straight C++ 
class is that the constniilor (ic. CalcTaxes som,Taxes() in tills 
example) r<>r a SOM class c:an't have any arguments (we’ll sec 
latter in this articles how to use an equivalent mechanism with Meta 
Cla.ssc's). We L:an also override somlnit, which is a iiictluxl defincxJ 
in SOMObje^t, but it can't take any argiimenis cither. And anyway, 
you t'an't u.se an elFidenl exceptions meelianism with either 
constructor or somlnit, so we'll see in the next cxamfile how you 
should use Inilialixe and TIninitialixe methods to properly set up 
and unset your objects. In liie case of som_1axes, since it dexsn't 
do much, we simply use a coastructor whicli can't fail 

In this example, there's only one new method, CalcTheTax. 
CalcTaxes_som_Taxes is inheriting from SOMObject which is the 
nxil for SOM classe.s, and has methods like somGetClass and 
otliers wliich well see uses for later 71ie keyword IN found in 
the parameter list of CalcTheTax means that the pantmeter is 
passed to the method and, even if modified, not returned. As 
we'll see further lx‘low, the keywords OUT and INOUT can also 
be used, OUT meaning that the parameter ikx^sn'l receive an 
initial value and Is returned by the method, INOUT meaning that 
ilie (xirameter is pa.ssed to the methtxl with an initial value, and 
that the methoii can return another value. In fait, IN , OUT and 
INOUT are just for reading purposes, since these macros expand 
to nothing, they’re just here as a reminder for SOM’s in, out and 
inout keywords. But the same rules don’t apply. A SOM out long 
value would be tran^sformed in the .cpp as long ‘value. Here we 
have lo say OUT long "value. In addition, the uscxl SOM c'las,ses 
woift get an extra * (.see the note on page 6l of develop 26). 


SOM Objects and SOM Classes 

SOM is a dynamic' environment where classes themselves 
are in.staniiated as objects in memory. Thtise special objects are 
called class objects to differentiate tliein from simple objects, but 
lljcre are objetas nonetheless. Notwithstanding its name, 
SOMObject is a SOM ela.ss. SOMCIass is also a SOM Class 
inheriting from SOMObject. To simplify coiTif)lex malLcrs, let's just 
.say tliat when the SQM Runtime starts, it instantiates a class 
object of iJie class SOMCiassMgr, a chss ohjecr of the class 
SOMObject, and a class object of tlie class SOMCIass. When you 
are insLanLiaiing an ohjea of the class CalcTaxes_som_Taxes for 
the ttrsi lime, SOM ataually instantiates a class object for your 
class, and then, the object you rc<:]uesLed. The t:lass object of 
your class Is iastantiated only once, whatever die numlx'r of 
olijcxts of tills class you an: instantiating. If you are interested in 
more details, please refer to eliapter 2.1 of the Users Guide. 
Throughout this article, I made an effort lo distinguish a SOM 
object from its SOM class, where it made sense, but mosdy 
they're the same, Wiien Tin writing about a method, for example, 
1 may refer to It as the “SOM object method" or ''SOM class 
method”, but it doesn’t matter much. 

The next step Is to write the x pp file. It’s in that .cpp file that 
you are going to either include or link lo your okl Iegai7 axle: 


Lisiing 3 
d2som_Texes.cf^ 

CalcTaxes sot! Taxes::CalrTas;es_softt_T 0 xou E) 
t 

fTax = 8; 

I 

long CaicTaxes_KOBi_T3xes;: CalcTheTax (INOUT Snviranaient 
*ev, IN value. IH short kind) 

t 

if (kind = 0) return valuo: 

else return(va!tie + {(value ' fTax) / 100)); 

I 


A liig differtma^ between C++ and SOM is tliat, by definition, 
all rields tjf a SOM cla.ss are private \o that object, and all methods 
declared in the releascxrrder list inu.si Ik: public and virtual ITiat 
means that if you want classes, inheriting from your class, 
accessing your fields, you have tt> provide accessors for them. 

The next .step is .simply to build the SOM shared library. 
Using Metro Werk.s Code Warrior, well need an extra file 
wlikh ctmtains the only symbol w^hich has to be exported, for 
C!'M (Ctxle Fragment Manager) and SOM ti) be happy. This 
.symbol is the complete name of your SOM class concatenated 
at the end with ClassOata, le. CalcTaxes_som„TaxesClassData. 
The name of the file musl end with .exp and may Ix’ pui in 
the project, ie. d2som_Taxes.exp. ff there are more than one 
SOM class defined in a particular library, then all the 
ClassOata symbols should be listed in the .exp file. Another 
way to achieve symbol export is to use the tpragma export 
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directive in your ,hh file a.s in the following example (see I he 
Solid project for more deUtilfi): 

Kpragma export on 
class MSolid_som_Solicl; 

^pragma export oft 

Since the Spragma dtrect_to_som directive Ls on, the 
development environmenl ckK\s tlie right tiling und adds the 
Cl ass Data extension automat ieally. 

Yf)u then create a new projecl hastal on the ‘'ANSI C++ 
Console P1>C (I)Lir (hro i) (jr “Sid C++ Console PFC (UUr (Fro 
2) stationery. You add the .cpp source file, the .exp file, and tor 
convenience, the .hh file (duplicate the .h 'farget preference, and 
c'hange llit^ crxiension to Jih) and other source or resouice Oles 
it' you need. Yt>u also add the somlih shared library which 
contains the SOM ccKle, and you mexiify the following sellings: 

• FFC Taiget: you select Stiared Library as pnjject type, you 
type in the name you chose, and you type^ cfmg as creator, 
unless you‘re providing your own fjundle. 

• FFC Linker: you clear all Entry Points fields 

• FFC PEE: you select either the “ase the “exp” hie" or “use 
^pragma" iterm in the Export Symbols po[)up menu 
def)ending on the way you desire to ex|x)rl symlxils. 

Depending on the: ccxic? you either include or link to, you 
may or may noi gel rid of a lot t^f unuseful libraries automaticalty 
put in the project stationery. In my case, 1 only need to ktx^p MSL 
ShLil>Kuntime.Lih and you build the library.., (1421 fjyles). 
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ccjinmatid line, and you can turn it on ([X)[>u(> menu) in the C/C++ 
Linguagc preference; panel in MetroWerks CtxleWarrior. You am 
alternatively use the #pragma dtrecLto_som on, if you prc'lcT. 

Using the SOM Shared Library 
It's very simple to ust^ the SOM shared library in yt>ur 
application project (or another SOM shared libniry project, in this 
case it's Generalltem_som_ltem), you just have to add the 
4;txesSOMLih to your project window, add the #inclyde 
“(l2sQm_Taxes.hh'’ directive in your .cpp source file, alliKate the 
SOM object witli a new, deallocated it with a delete, ant! use it as 
if it were a C++ t)bject everywhere you ntxxl it. 

Hut let's lake a closer kx)k at the d2som_Item project first. 
Tlie .hh is: 


d2soniJtem.hh 

fliftcliirfft **D 2 soib Taxes,hh” 

rlafiii neiief.ilTten soja Itera : public virtufll SOMObfect I 
publ U' r 

Gefio ra 111 piii_som_T t rra (): 
virtual ^tneriiiltetn„i;uit_t U'in(): 

virtual void InitialiisetlNOUT brivironmnit *c'v): 
virtual void UninitiaiizettNOUT Environaent *ev): 
virtual void SetTheBTPrico{INOUT EuvitOTiiBent *ev. IN 
lon£ thePriceBeforeTax): 

viriufll void Set?roductOrService(INOUT Environment 
*t'V, IN sjliori kind); 

virtual long CalcThcATPrteotTNnilT Rnvt ronrit=inf ; 
private; 

fihort fProductOtServiee: 
long fBe foreTaxValue; 

CalcTnxes_som_Taxcs ^ tTheTax: 
fl tf _S0K ENABLED 

§ (] rn guL-i SONRo 1 pia r eOrder (CalcTheATPrice. 

St*t 'rliuHTPr Ice, SetP rodiictDr Ser v ire♦ 

Tnl t ial i ze, llninltiallze) 
(^pragma SOHClBssVeraiori ((lofteralllein_uoio_Tl.em, 1. D) 
ffpragma SOHCailStyie IDL 
jjfendif 
1: 


Note that you can't oil anything which might thitiw an 
exception from somlnit or somUninit or from tlie eoastnictor or 
destructor of die C++ dass. Tliafs why it’s usually a gcxxl ido to add 
to all y<xir SOM classes the methfxLs Initialise and Uninilialize which 
will Ix" able to rhrt>w exceptions and which will Ix^ allied just after 
the alkx'aiion and just lx:4bie die dealkxation of the SOM olijett. 


In lx)ih MPW and MetniWerks cnvimmnenLs, die Enums 
should Ix.^ ini (lequiaxi for l)irea-To-SOM compilation), and it's a 
good idea to either generate MacsBug symlxils (for (S8K) or 
tracelracks (for PowerPC) to ease yt>ur debugging (don't forget to 
turn diem off for your distribution release). You turn on the Direct- 
To-SOM compilation in MPW MfCpp with ihe-som dirtxiive in the 
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In the example telow, we do cneate die CateTa>ces_som_Taxes objea 
in rtre Initialize metluxl. Tlie inrere^iing part of dZsom_ltem.epp iii: 

LLstin^ 5 

c^som_llem,cpp (extract) 

void Gf>!tifiralTtstn_Sfji)i_Ttfiiri: iTnlti^al 1 ?,i 3(TN0UT Rnvlronmeni 'Cv) 

! 

ntieTax = new CalcTaxeK_titiat.T4ixe£: 

1 

void Gene ra I It enuE onultein:: Uninit i all zedNOUT Environment *ev) 

( 

delete fTheTax; 

1 

long GenerallteiiL.HO0LiteEi: ■Calc:'i‘heA'lTricG(INOUT Environment *ev) 

\ 

return(tTheXax->CaicTheTax{ev ^ fBeforeTaxValue. 
fProductOrService)); 


After that, we set up our new project file as before, witliout 
forgetting to add the Taxe^sSOMlib, and we do a build Now we 
can test our new SOM sfiarcd library. 

To test all the SOM sliared libmries in this article, J built one 
Testing application, lesrLibraries, wliich uses coasolc output to 
liiliLc only ihe SOM ctKling, Its projed file contains, of course, 
somlib and all tlie SOM shared libraries directly used (>y the 
application. For instance, it uses diiectly the soinjtem object but 
not the sorn^Taxes ohjeti wiiich is used indirectly via die somjtem 
object, so only die lleuiSOMLih is included in die project window- 
arid not the TtixesSOMlih. Of couise, when the application is 
kiunclied, the PiTx:es.s Manager has to find the 'faxesSOMLib 
somewhere (or else you will gel the usual Finder mess:ige sjiying 
that die TaxesSOMLib couldn't Ik^ found, and the application won’t 
launch). So for pure ease of development, I .set up projects to have 
all my .shared libraries (some dirougli aliases) and the application 
in the same folder. If you’re' inteiesled in kntwing of others places 
the sliared libraries can go and still be found by the pRxress 
Manager, look at the “Mac OS Runtime Architectures’’ document 
availalile on the “Rererence Library" DevdofKa- CD, 

1’he interesting p:\n of tlie scjurce code of 'I'estLibraries for 
rhe inanipuiaiion of General I tem_som_ltem i,s: 

Ustifig 6 

TsstLifarartes.cpp (extract) 

//iriL-lude ‘‘dZscfin^iteHi.hh" 

mainO 

( 

long thePrice: 

AutoTnitKnvi ronriJpnT 

Rnv [ ronmf'nl ” (FnvI rorniieriL *)ft(E:civ? 

Genera liLGin_£iom_ It era* thelLem = new 

General It em_Koui_ltejti; 

theltemDlnitiaiize(evj : 
thelteraOSetTheBTPrlceCev. 100): 
theItem->SGtProductOrService(ev* 0): 
rhePrlfie = theTTetni->CaIrThpJ^TPr 1 ce{ov) ; 
printf(-Generat Ttein» ^icrvice, IhcPrlcc = 
thePrice): 

th^^iteKl->SetProdllctOrService(ev, 1): 
thePrice = theltem->CalcTheATPricetev): 
ptlntf(*'General Item, produett theprice XldVnVn*', 
thePrice); 

theTteiB->Unlnitialize{ev): 
delete the!tern: 

I 


And the execution printout is: 

GGnera! ItGm, SGrvice, thePricG 100 

General Hem, product. thePhee - 108 

Sint:e we need an Environment* variable to pass to the SOM 
mcdKxLs, wc simply use die specially-dc^lned-^o^-Dirca-Tc^SOM- 
C++-compilation AutolnitEnvironment structure. We could also use 
Environment* ev ^ somGelGlobalEnvironment();. When you are writing 
an afiplicaiion, you aire only alx)ut one Environment stmeture, .so 
you might as well be using the one provided by the somlib shared 
library (sofnGetGlobalEnvironment). if you are writing threads, then it 
Ls imperative to aikxjale one Envinmnieni varialde on die stack of 
each diread (AutolnitEnvironment) or else you will lie in trouble. 

Inheritance and Polymorpiusm 

Now that wc have defined our soin_Ileni base class, let’s 
inherit from it. 

All the previous SOM classes inherited from SOMObject. but 
this Lime we’ll inlierit from Generalltem_som_ltem, leading Ui the 
following declaration, implementation and usage: 


Listing 7 

MSo!id_som_Solid declaration, impienimmion and usage 

class MSolid som Solid ; public virtual 
GeneralTtem nnin Item t 
puhl1c: 

virtual void SatQtiantity [INOUT EnviromiiGnt ^ev* 

Ifl short bowraany): 

virtual void SetUnitPrice(IKOUT Environment 

‘fiv* IN short hovinuch); 

// Dverridinj? 

virtual void Tnitialize(TMGUT Environment *ev): 

virtual long GalcTttoATfricedNOUT EnvIronnHjni *cv): 
private: 

short fOuantity: 

short fUnitPrice: 

#if _SOK_ENABLED_ 

/fpragms SOMReleaseOrder (SetQuantlty, SetUnitPrice) 
//praguia SDMCla^^HVP-^SiQ^ [HSolid som .Solid, 1, 0} 
Ipragtna SDHCa 11 Style TCh 
lend if 


void MSolid_sora_Solid: :SetQ:uantity(INOUT Environment ‘ev, 

IN short howroany) t fQuantity - howmanyD 

void MSoiid_soiii_Solid::SetUnitPricB(INOtJT Environment *ev, 

IN short howinuch) t flJnltPrice = howmuchil 

void MSol Id noni Sol Id:: Tni r lal ize(TH0UT Envlronmenr *ev) 

I 

this >GenGralitem_Hom_llem::initialize(ev); 

Set P roduct GrS e rvice{ev, 1): 

SetUnltPrlcetev. 15): 

I 

long MSolid som Solid::CalcTheATPrice(INOUT Environment *ev) 
' I 

SetTheFTPricc(ev. fQuanLUy * fUnlt Price): 
return(this 

>Gonoralitcm_som_l trm I: Calcl'heATPrice (ev)) i 


[ 

MSolid fsom Solid* tbeSoUd = new MSoVid_f:oro Solid: 
theSolId >Tnft}alIzeCev): 

IbeSolid >SelQuaiitiLy (ev, 10); 
thePrice = theSolid->CalcTheArPrice(ev): 
printfl*" the Solid Price “ %ld\n\n", thePrice): 
theSolid->Unlnitiaiize(ev): 
delete theSolid: 

[ 
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A^> you can see, the Initiaiize tnciiiod first calls its parent 
Generalltem_somJtein::lnitiali 2 e, and then calls methfxis whic:fi arc 
defined only In die |>arenr (such as SetProductOrService) or in this 
class (such as SetUnitPrice) in the same way. 

Here's the predictable result: 

theSolid Price = 162 

As we see, thi^ cialtin^ aj>[>licatiQn can as easily use mcthtids 
defined fiy ilie class {SetQuantityJ as meihcxls defined by die parent 
(CalcTheATPrice) in the same wjiy. So, basiadly, you design and ttse 
inheritance the sjime way as you wtjuld in C++ or Objext Pascal or 
any other CX)L Ttie tMily big difference is that the medjtjds leside in 
different sliiiied libraries (SetQuantity is in die StilidSOMLib shaRfd 
library, whereas CaicTheATPrice is iii dx* IlemSOMlib shjiied lifirary), 
although diey're lieing c'alled the same way, Ttds tncclianism is 
transfyareni Ixxli for the developer and for die user Tliat also means, 
as we'll see in more tletail furdier (xlow, that the CaicTheATPrice 
method can he changed tn die jiujent, witlimit SoiidSOMLib Ixitig 
any diffeieni, die fragile l>a.se class problc'in k solvcxl. 

Under its apparent simplicity, Ixith in design and usage, lire 
main strength of SOM resides in this mechanism, that ail the 
methexis of an object don't have to be all in the same shared 
lilirary. Take five to think about iL,, 

for(time=TickCount{);TickCourH()<tifne+300;): 


Meta Ci^sses 

A good feature of C++ is diat we are able to allocate and 
initialize (witli parameters) a class in one statemem such as 
CRect r(0. 0, 50, TOO); or CRect *r = new CRect{0. 0, 50, 100);, 
Although there Ls an ec|iiivalent mechanism in SOM, it's neither 
so direct n<ir so easy, but at least it exists. 

We saw in the previcjus examples that our classes inherit 
from SOMObjea. Well, we i:an also liave a class inherit from 
SOMCIbss, which we'll use to allcx'ate and initialize (widi 
parameters) our objects. This class is a Meta Class: 

And this leads to the predictable rc‘,sult: 

CarWash with wax Price = 200 

CarWash without wax Price = 50 

MtimPl K INHERJIANCL 

We first create a SOM class (Attributes_som .Attr) the usual 
way, then weTe going to create another SOM class 
(MTires_som_Tires) which inherits liodi from 
Attf!bules_som Attr and from MSolid_som_Solid which inherits 
from General Item^somjtem. 


Listing 8 

MCarWash_som„CarWash declaration, imfikfmmkiikm umi tmge 
class MCarVfash_i3cim_CprW.ieh; 

class MJtCarWash_SDai_CarW3sh t public virtual SOHClass 
! 

public: 

virtual MCarWashesom_CarWash' CarWnshCreate(IHOUT 

Knviranment ^ev, IN short withWa?(): 

#if _S0M_F:NABhKD 

^pragma SOHRcleaseOrder (CarWashCreate) 

^pragma SOMClassVersion (W MCarWash_som_CarWasti . t, 0) 
#pragaia SOHCallSlyle TDL 
{fendif 
h 

class M:CarWash_SOti_CarMash : public virtual 
GeneralTrem anm Item [ 
public: 

virtual void SetWithWax(INCUT Jiuvironinont *ev, 

IN short yesOrHo): 

// werriding 

virtual void InittalUe(INCUT Envirouraent *ev): 

private: 

short fwithWax: 

#if _SOM_ENABLED_ 

pragma SOKReleaaeOrder (SetWithWax) 
pragma SOMClsflsVersion (MCarWash_sutn_Gartfash* 1, 0) 
(fpragma SOMCa 11 Style IDL 
^pragma SOMKeiaClaSB {HCarWash_SOTiL_CarWash» 

H_MC a rWash_soifl_Ca rWa s b) 

ilendif 

I: 

HCarWash_sojii CarWash* 

H_MCarWaah_soffl CarWash: iCarWashCreate(INOtlT Knvironaent 
*ev, IN short withWax) 


I 

WCarWash^Roni CarWash *obj ^ nev MCarWash_soia CarWash; 
if (obj) obj OTnitiaUaeXev): 

If (obj) obj >SelWtrhWax(ev. withWax): 
return obj: 

I 

void MCarWash_soiit_CarWash:tSeiWl thWax(INCUT Environment 
•ev, IN short yesOrHo) 
i 

fwilhWax - yesOrNo: 

if (rwUhWax) SetTheBTPrice(ev, 200): else 
SetTtit'BT?r]ce(ev, 50); 

1 

void MCarWash_Boni_CarWashIjTnttiallze(INCUT EnvironmonL *ev) 
I 

this- >CeneralItett_sani_iteni: :Tnt t ialixfi(ev): 
SetProductOrService(ev* 0): 

\ 

I 

MCa rWa sh_som_Ca rWach * theCa rWash; 

H_HCarWas h_s oin_Ca rWa uh ' theCarWa s hMe t a C i a e s: 

theCarWashKetaClass - new M_MCacyasb_soii_CarWaali: 

theCarWash " theCarWashMetaClaGS->CarWashCreaie(ev* 1): 

rhePrice “ theCarWash >C6U‘ThGATPrt ce(ev) ; 

printF{"CarWash vith wax Price ^ XldVn“, thePrice): 

theCarWash >Uninitialize(ev); 

delete LhoCarWash; 

theCarWaah theCarWashHetaClasa->CarWaahCroate(ev, 0): 

thePrice = theCarWash >CalcTheATPrice(ev5: 

printf("CarWash without wax Price “ %ld\n\n** thePrice): 

theCarWasb*>Uniiiitialixe(ev): 

delete theCarWash; 

delete theCarWashHetaClass; 

t 
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The .hli is noi very dilTereni, Alter the usual ^include 
directives, vve find: 


lusting 9 


MTires_soBi_Tires declaration and usage 


claas HTireE_soin_Tires : public virtual 


Attrlbuiea_sota_Attr, public virtual MSolld sotn Solid t 

public: 


MTlrea_aon_TiresC); 


virtual ''MTircu_ijDiii_Tire3(); 


V1rtual short BrandNewC): 


9U SOM_KNABLBD_ 


ffpragraa SOMKeleaseOrder (BrandNew) 


#pragraa SOMClassVersion (MTires som 

Tire FI, 1, G) 

^pragma SOMCallStyle IDL 


jfendii 

1: 


1 

MTi reg_fioiiL_Tires* th^Tlres = new HTires_ 

.scn 0 _ Tires; 


// fmm .som_Tirw 

iheTlres'>lnitiaiize{ev): 

// fmm ^tm_Stitid 

theTires->Set0uantity(ev, 4); 

/f from si>m_Sc)liU 

theTlres’>SGtUnltPricpfev, ^00); 

// fioni iiom_Siilid 

theTires^^SetTiBiGBnfaroRotylIon(ev, 3): 

// fnjtn jiotn Aur 

theTires >SrrProvonanretev, 1/): 

// fnim Mjm Aitr 

thePrice " ihcTlrcs ^CalcTheATPricetev): 

// tjiiim Mjni Solid 

printff"ihcTirea Price = %ld\n\n”, thePrice): 

theTires >tJuinitiali 2 e{ev}; 

// from somjtcm 

delete theTires; 

\ 

// from som_nftTi 


I-eading to the predictable result: 


theTires Price = 2160 

The imeresrin^t fact to note alxHii the som Tires object is lhal 
although we see it as one* object, its exxie and methods actually 
reside in 4 differeni shared libraries: TiresSOMlJh, AltrSOMLih, 
SolidSOMLib and itemSOMlib, and ii\s all transparent. 

I advise those who are interested in knowing how SOM 
resolves the classic uinbigyiLics problem when dctiling with 
multiple parents who have clifTerent methods with the same 
name to read chapter 4.2 <Inheritance) of the Users Guide, since 
j see no point in repealing here the excellent c^xplanallons found 
there. I'll just say that somehow, SOM deals wtlfi the ambiguities. 

Ijrr's Rkap Some Beinui ii^ 

New that we have enough classes lo play with, lefssct: how 
we gain fnim the use of SOM. 

Let's say that suddenly, tlic state gets greedy (it happens!), 
and the sales tax on prcxlucts goes from uj WHk 

Well, no l>rg ifejl. We just an>pLm the som_Taxes f)rojc‘tl, 
change the line flax ^ 8; by flax = 10;, r\xf>mpile tliis SOM shuaxi 
library, and tltitls it, we’re done, we don’t fiave lo do any other 
building of any other library or application using this lib. W: jitsi 
launch our testing application, and the primed results will .show 
that all prcxlucts (Ixit not the services) arc nc)w 2% more expensive; 

General Item, service, IhePrice = 100 

General Item, product, thePrice ^110 


Gocxl, but we could have achieved die .same result with a 
simple dynamic shared library Ixised on CFM, .so in that case, 
although SOM didn't hinder, it didn’t do anything that we 
couldn’t have done in another way. 

Since, when prices go up, consumers tend to buy less. The 
providers have to react in some way; most of the time they 
offer discounts.,. 

So we go back to the .som_ftem class, and we’re going to 
update it to version LI, intrcxlucing the djsc:c>unt concept (to 
prevent confusion, I hitve a separated ItemDiscouni project, wiUi 
new d2som_lLC[tiDiscouni.xxx dies, but the built shared library is 
still ItemSOMLib): 

As usual, we start at the .hh, which is now: 


listing 10 
d2som_ltem.hh v.11 

clasH General It eni_.soin„Item : public virtual StMObject I 
public: 

Generalltem fioin. Tt«^wO : 
vi rtual "Clene tn 1TteBi_sc!ii_ T t ea (); 

virtual void Inlttiil i3i;€^(TN0UT Kiivirqrioent *ev); 
virtual votd Unini l ini laetlNOUT HTivironaent *ev); 
virtual void SeCTheB'lTricetINOUT Enviromcant *fiv, IH 
long ihePriceBetqreTax): 

vitLu^ void SetProductOrSe^rvlcaClKOdT Environment 
*ev, IN short kind); 

virtual long CalcThRATPr ireflNGIIT Rnvltouiiietic *evj: 
virtual void SarlteinDInroun? (TNOGT Khvironraent *ev, IN 
short hownuch): 
private: 

abort rProductOrService; 
long fiiefareTaxVaJue; 
short flteniDlscount: 

CalcTaxes_soDi_Taxes* fTheTax: 

#if _S0M3NABLEG 

pragma S0MRelea.‘?eOrder (CaU’ThoATPrice. 

SetTheBTPrlr.e, Set Prod iictOrService, 

Initialize, Uninitialize. 

S at1temDiscoimt) 

^pragma SOMCi ass Version (Ctenaralli em soa^Ttem, 1. 1) 
ifpragTna SOMCallStyle IDL 
#en{l i f 
I: 


A.S you t'un see, there are only minor modifications. Wc 
intnxiuced a new methcxl SetltemDiscount which we also place 
in the rcleaseorder directive, and a new Field fItemDiscount, and, 
very iuif>onant, wc changed the minorversion u> 1 (it was 0). 

SOM Version Nijmiifrs 

Since I couldn't have explained it Ijctter myself, lierc^s 
ihe exccT[)L from the Users Guide about major and [iiinor 
version numbers: 

'"'Ihesi^ numbers are cheeked against the version mimlTcns 
built into the class library to determine if the clafis is a)mpati!>!e 
with the clienrs exfxxriaiions. 'ITie cla.ss is compatible if it has the 
same major version nunilxT and the same or a higher minor 
version number. If the class is not compatible, an cTror is raised. 
Major veniitm mimlx-rs usually only change when a significant 
enhancement or incomjyatible change Ls made to a cktss. Minor 
version numlxrs change when minor enltancemenLs or fixes are 
made, Downwartl compatibility is usually maintained across 
changes in the [iiinor version nmnlx^r," 


72 


And TtCKN SOM... 


In IVlAtTncii • February 1998 










We also mcxlify sligluly llie xpp: 


Lisling II 

d 2 somJtem.cppv,t ,1 {eictract} 

void Generalltee ROiB_Tlf!fli: :Tni tiallxedNOirr Enviroiijpent 'ev) 
{ 

fThfiTax now Calc:TaxGiEs_som_TajtGs: 
riiemOiiftouflt ^ lb: 

1 

long Cenerallteiit so3» Itojn: ;CalcThGATPrioG(TNOIIT 
Environment *ev) 

! 

long theValue • fReroreToxValuei 
fheVttlyo (ihnValue * fItejuDiscount) / 100: 
retumCrnieTax >CaicTheTax(ev* theValue^ 
ft^roductOrSeirvice)): 

void Genetalltem soid Item; :SetItenDlflcouiiL {TNCitJT 
Environment *ev< IN nhorr. howniunh) 

\ 

fTt omlli EicQUnl = howmuch: 


We build ilie new library ihc usual way, and now we reap 
the SOM Ix^nellts: we tlon't have to rebuild all the libraries 
eoniaining ilie elasses which tnherlt from somjtem (ie. 
som_CarWash, stjni_Solid, ,st)m_Tire.s, soin_Car, som_Tapi‘s), nor 
do we liave to rebuild our testing ap[>licatiQn. Tlie simple act of 
rebuilding the new version of som^ltem is enough. If we launch 
the testing application, we will get the Following printer! result: 

General Item, service, thePrice = 85 

General Item, product, thePrice = 93 

CarWash without wax Price = 43 

CarWash with wax Price - 170 

iheSolid Price = 140 

That means that if the whole set of iliese libraries and testing 
application was a complete .solution installed on your customers* 
Macintosh, to deal with both the new Lax and the discount 
countenneasure, you just mcKlify and rebuild 2 libraries, and you 
have only those 2 to .send to your customers to update them. This 
is lx)lh a gain in time (we only deal with 2 ljbrarie.s iastead of a 
wiiole complex global project), and a gain in cost of gcxxLs (we 
only have to send away 2 libraries instead of tlie whole 
application). Whatever ways we could choose for the distrilxition 
(floppies, Internet, etc*), it will always be cheaper to send a few 
small items than one big item. 

ViatSlONING 

Since we now may have 2 different versions of 
Generalltem_som_lteni floating in our customers’ installed base, 
lei's see how we ran deal with k and proflt from it. 

The more die consumer buys, die greater die dLscxxint. lei's 
say that If a consumer buys UXXJ tapes, sThe doesn’t expects to pay 
die price of 1 tape limes 1000. Now that we have this neat 
SetltemDiscount meihtxJ in our Generalltem_somJtem ckss, ii w'oiild 


lx: grt^at to lx: able to rail it from one of its de.scendaiiLs. The 
f>rol)lem is diat diLs rneifuKl d(x\sn’i exist in the version 1.0 of 
Generalltem som Item . St> let's caraie a Mjm_TafX‘s class tinling 
with di.sc(3unis and see how it’s done. As usual, the .hh fust: 


12 

MTapes.som^Tapes {kekratkm untl fmage 

rljiRs HTiipGs_soni_TapGK : public virtual MSDlid_so(t_Solid I 
public: 

MTapes_sora_Tapes() i 
virtue 1 -MTape$_sdm_TflpGfl(): 

virtual void SetDiscount [INOIJT Enviroumi^nt ’gv . TN 
short howraucb); 

Hf SOM ENABLED._ 

//pragma SOMRclcaHcOrttcr (ScLlllscounL) 

//pragma SOMClasaVeraion {MTapes^sotn.Tapea, 1, 0) 
ii pragma SOMCaiiStyie IBL 
tfcTidif 
h 

t 

MTapes sora Taper,* theTapcR “ new «Tapcs_so™_Tnpcs; 
tbeTapes ^Ini t ial IiEt»(cv) : 
theTapCfs >SctQuutiLiLy [gv. 1000 ): 
tlicTripcB >SetUnitPrlcctev, 5): 
ibcf^cico = thcTapes->CalcThGATPrice lev): 
printft'^thGTapGH Price (ne special discount) = lldAn**, 
thePrice): 

theTapes^>SetDiscouivt (ev, 25); 
thePrice = thGTapea->CalcThGATPr) cg(ov): 
printf("theTapea Price (dtscoiiut * 25V%) ^ 
rhnPrico): 

rhcTapcG ^ScLDiscouni(ev, /b): 
ihcPtlet' ^ LbGTapes->CalcTheATPrice(ev): 
prliaf {'‘theTapes Price (discount ^ 75\%} - 
thePrice): 

theTapes'>Unird.tiali 2 e(Gv): 
delete theTapes: 

I 


Let's see how die SetDiscount itiediod is dvuU with in the 
.cpp flic. 

There are many, many w^ays to verify at runtime if the 
version 1.1 of somjtem is prescmi, and thus, if wt* nm tuse its 
discount feature. 

Just like any g<Kxi Macinttwh developer checks with Gestalt Xo 
see if such or such feature is available, inskrad ol t htx'klng the system 
version and then making sonx' iissLimpiions alxjut wliich featuie is 
iliem or ntx (these assumptions, often unjustltkxl, have a way to bite 
die devclojKT I Kick (or radier her/liis (iistomt:rs) at a later ebte), we 
can check the availal>ili!y of any lUellKxl liy just Lisirig iLs name, 
Two .situations can arise; you have the .hh of 

Generalllem_somJtem v.l.l, diis should lx‘ the u.sual 
situation, or for some strange reason (l)ui strange Ls real life), you 
don’t have the .hh but at least know the prototype of 
SetltemDiscount t if you don't, then yoiiTe stuck). 

Since we use dial code in a descendant of 
Generalltem_som_ltem , and any metlvHl of Generalltem_som_ltem 
is in die si:ope of the methexLs of that descendant, we simply 
write in the first case: 

if (sotaRGBOl vcByNaiBGlthls, "Set It cun I scount ") 1 “ 0 ) 
rh I s >SeT T tcinHisoouni (ev. buwmuch): 
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Or, in the second ca-se: 

typedef void [*£iincptr)(SOMObject*, Environment** short)j 
funcpir cailit ^ (funcptr)soniEesolveByName(this. 

“SetItemDiscount"); 

If (callit) (*callit){this * ev, hownuch)i 

And* youYe done. Just launching the testing application 
yoiill get, if Generalltem_som_ltenn v.Ll is present: 

theTapes Price (no special discount) = 4675 
thalapes Price (discount = 25 percent) = 4125 

theXapee Price (discount = 75 percent] = 1375 

And. if GeneraiItam_aoiii_Item v.1.1 is not present: 
thsTapee Price (no special discount) = 5500 
theTapee Price (discount -= 25 percent) = 5500 

theTapes Price (discount = 75 percent) = 5500 

Now you can understand why the consumer would be 
pleased with the version 1,1 if s/he qualifies for the 75% discount. 

Some other ways to check for the availability of 
Setitem Discount: 

Using the somRespondsTo method defined in the SOMObject 
class (which is your ultimate ancestor): 

char 'theHethodNaiiie = “SetltemDi^count"; 
if (thls ->soroRespondsTo{&theJ1ethodName)) 
r SeUtemDiscount avaUnblc 7: else t it's noC/; 

Using the somSupportsMethod metiKxl defined in the 
SOMClass class (which is an ancestor of your class); 

char ^theMethodNatne = "Set ItemDiscount” : 

SOMClass "^theClass = (SOHClaas *) this->so!iiGeiClasa(); 
if {theCiasa->somSuppoxtsMethcd(4theKethodNamE]) 

/* SciJ remUisrtjun i V: e I ee /* n s nt>i7: 

theC lass ‘ >soiiF t ee (); 

if you insist on dealing with version nuniheis rather than 
fciiLLircs* then you can test if a direct instantiation som_ltem 
v.Ll works: 

SQMObject ‘theObjcct: 

theObject = somNewVeraionedObjact (GeneralIteai_sora_Ite]nH 1* 0); 
if [TheObject f= 0) I 

/• :i major\^mi(>n of I and a ndnor version >= 0 has been found 7 
sojidlelsaeeOb Jec LRefereiice( thoObjcct); 

1 e 1 s e /* vj .X unav:i iliibic, should never happen,. = 7: 

theObject = somNewYersianedObject (General It etD_5on]_ltG]n. 1* 1): 
if (theObject != 0) 1 

r a mHjorvcrsiiori of I and a minor version >= 1 has been found 7 
sQuaPeleaseOh jectReference(theObject) ; 

] else/" most I ikeh' onk v. 1,0 b there.., 7; 

As we saw in the ''Major and Minor Version Numbers” side 
bar, if you ask for n.O, it will .succeed if n.x is present, whatever 
the value of x. If you ask for n.m, it will succeed if n.x is 
present, with x m. It will fall In all cases if only p,x is 
present, with p ^ n (except if you a.sk for 0.0, then it will 
succeed if any p.x is present). 

in my example, if both vJ.O and vd,] are present in the 
same folder as the te.sting application, v.l. l will be chosen by 
default, since SOM, unless told oiheiwise, will always load the 
higher possible version. 

If you insist on dealing with version numbers rather than 
features, tlien you may also check a [>arcnt version with tlie 
following code (remember that in this case, although 


Generalltem_som_ltem may be v.l.l or v.kO, MTapes3om_Tapes 
is v.1,0, so it doesn't do us a lot of good testing the version of 
MTapes_som_Tapes): 


Listing 13 

GeiThlsParentVersion impkmentation and usage 

short GatThlsParent¥erfiion(SOKClass 'tbeClass, char 
'className, long *majorVersion* long ’rainorVersion) 

shorx li result = -1: 

SOMClass Sequence parents ^ t heCl ass - >3oinGetPa rent s() : 
for {i“0: ti<parents-_length) && (result ^ ^1): £++) 
[ 

char 'parentName * parents._bufferti]- 
)soiiiGetNaMG() ; 

if (strcmpfparentNanie. classNanie) = 0) 

I 

parents._buffer [i] ->soinGetVerflionNumbers 
(majorVersionH tainorVersion); 
result = 0; 

I 

else result = 

GetThisParentVarsion(parents*_buffer[ij, className, 
rnajorVersion, minorVersicjn) ; 

] 

if (parents._length) SOKFree{parents.^buffer){ 
return(result): 


long tDajorVersioitH minorVersion; 

SOMClass 'theClasE - (SOMClass *]tbis->somGetClaEs(); 
short ok = GetThisParentVersionCtheClass . 

"‘Generalltem^.soiii^Itein" SmajorVersion* ^minorVersion); 
theClans-ksoniFreeE): 

if (ok ^ 0) I* the parent was found* so wc can test the veniion numbem */ ; 
else /" the parem was not found* something is really weird here... 7; 


Since SQM offers multiple inheritance, the somGetParents 
method returns an army containing all the direct parents of liie 
c'lass. There Ls also a somGetParent method wliich returns only 
the leltest parent, but I strongly advise you to ignore that one, 
because it might well get you in trouble in the future (ie, .some 
.SOM classes, developed by other developers and wliich you are 
using, which were single inheriting from one parent begin to 
inherit from many parents). 

Exceptions 

Since, according to MvirphyN law, if anything can go wrong, 
it will, iind according to some other bright person, Murpiiy was 
an optimist... ITs really a good idea to check our code against 
reality. 'I'he good news is that we can use C++ native exceptions 
with Direcr-To-SOM compilation, tlte bad news Ls that wc have 
to do some effort to make it happen. 

You can't throw from a SQM methtxf Its a compiler 
limitation. Maybe well be able to in future releases of C++ 
compilers, maybe never. What we can do, though, is to ask the 
compiler, through the SOMCheckEnvironment pragma, to generate 

aiWs to _som_check_ev and_som_check_new, after each call to 

a SOM mcthrxl or a SOM object allocation. It’s up to you to 
provide an implementation for those calls. You'll find mine 
below, but you are welcome to make your own. You get your 
diancc lo tlirow in those routines. 

Tlien* each time w'e’re unliappy with something in a SOM 
method (not enougli memory, disk full* and so on), we just fill the 
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Environment structure with adequate parameters and return. The 
second parameter (after ev) is tlie nature of the exception. In your 
case, it should always be USER_EXCKPT10N, then you can pass a 
string, and a long (in fact a void *). You can use tliLs lust parameter 
to just pass an integer code (that's what I do in this example since 
I don’t have much need for a more complex setup), but you’re 
welcome to allocate whatever structure you want, fill it, and pass 
its address as this last parameter (you'll have to deallocate it in 

_som_check_ev later). The exception mechanism you use Ls your 

own; you're free to do whatever you want witli iL 

Then in the calling code, we just try and catch the usual w^ay. 


Listing 14 

somSetExceplion_som_check_n©w, _som_check_ev, trying, tbroumg 

and caicbt^ 

void KCaE_soia_Carj :SetAudioSysteia(INCUT Envifonnsent *ev, 

IN short withOrWithout) 

I 

If ({withOrWithout f*- 0) (withOrNithout 1= 1)) 
somSetExceptlont^v, USER_EXCEPTrON. 

'■test 

soraSetExceptIon/MCar_som_CarSetAudioSyatem". (void Ol) : 
else fAudioSystem " vithOrWitbout; 

1 

^pragma SOKCheckEnvironment on 

extern "C“ void _aQifl_check_newCSOHObject; 

extern void _Roni„check_new(SOHOb'ject *SOMObjJ 

[ if (SOMObj “ 0) 1 thtowilii n 

extern void sota_(‘heck_fiv(struct Environment’): 

extern void _sojii„cbe€k_evCstruct Environment *ev) 

[ 

if (eV'>__ina5or) 

char ’name “ ev->exception._exception_naTt]e^ 

printf(“^sAn”, name): 

long ttowval ^ Clong)ev->exception 

somExceprtlonFreeCev); 

ev >^iiaJor = KO_EXCEPTXON: 

throw(LrowvaT)i 

I 


I 

try \ 

prfntf [**calling theCarOSetAudioSystemCev* 
iheCa r->SetAudioSystem(ev, 3 ); 

1 

catch(long x) ( 

printf{’’Caught the throw Sid In catch, Vn”. x): 
prlntf(“calling theCar >SetAudioSysteiii(nv, l),\n"): 
theCar->SetAudioSystem(ev, 1)j 
J 

) 


Leading to this predictable result: 


calling theCar->SetAudioSystem(ev, 3), 

test somSetException/MCar_som_Car::SetAudioSystem 

Caught Ihe throw 1 in catch, 

calling theCar->SetAuc(ioSystem(ev, 1), 

Ol’HKR Interestijng SOM Caij^ 

Tficrc arc many ways in sSOM to obtain mlbrniation on the 
SOM objects, their names, their parents, their verskms, tlK'ir 
methods, methrxl names, and mctliod pointei:s, etc. 


Consider the folicnving routines: 


listing IS 

PrintParent and PrintInfoAboutSOMObject 

void PriatParent{SOMGlasH *theClasa, long level) 

I 

SOMClassSequence parents: 
long i: 

parents = theClaas'^somQetParent^O: 
for (i^: i<parEntB ._lengthr i++) 

char 'parenrName “ parents._bufferti]- 
>SQmGetName{): 

printf("parent at level %ld: %s\n". i, level, 
parentName ): 

PiintParent(parents, buffer[il, leveL+l); 

) 

if (parents,_Iength} SOMEreeCparents._buffer): 

] 

void PrintlnfoAboutSOHObjectfSOHObject ‘theSOMObjecU 
I 

char ’theClassName: 

theClaesName = theSOMObject->scimGetClasBName() j 
printf (’'\nclassNaiDe: theClassName) : 

theClassNaiEy * t.hGSOMObject-)soinGetCiasB()- 
>6omCetName(); 

printf("ciassHame: ftsVn”, iheClassNarae): 
PrintPareiit(theSONObject >somGeLClass {) ♦ 0); 
long nbOfMethods th€SOIiObje£:t->KDiiiGetClassC) 
>fioniGGiU(umMethods (): 

prlntf("tiutiibGr of metbodB: %ld\n", nbOtXethodsJ; 
for(long ! =0: 1 < nbOfMethods: i++) 

soffiKetnclTd ThoKernelTD: 

EODtld tbeSomlD: 
theSOMObject >somCetClass() 

>somGetNthHethodinfo (i * &LhnK£7rncl in) : 
theSomlO ^ somConvertAndfreeKernulid (ihoKornol TT)): 
rhat *theMethodid - somMakeStringFromJd(theSumlO): 
printf {"method %ld; , 1. theHethodid) ; 

SOMFrtie( theSomlD); 

] 

I 


Tliese functions provide 2 different wiiy to gel the class name 
of the ptissefl object and oilier inlVinnaiion, When called this w'uy: 

theTIres = new MTifes_som_Tires; 

Printl nfoAboutSOMObject{theTires): 
delete theTires; 

It gives this back this result: 

className: MTires_soni_Tires 

className: MTifes_som Tires 

parent 0 at level 0: Attributes_som_Atlr 

parent 0 at level 1: SOMObject 

parent 1 at level 0: MSoiid .sonn_Solid 

parent 0 at level 1: Generalltem_somJtern 

parent 0 at level 2: SOMObject 

number of methods: 31 

method 0: SOMObject::somlnit 

method 1; SOMObjecl;;somUninit 

method 2: SOMObject: :somDupl[cateRelerence 

method 3: SOMObject: :somCompareRelerence 

method 4: SOMObjeGt::somRelease 

method 5: SOMObject::somFree 

method 6: SOMObject::somCanDeiete 

method 7: SOMObjecl::somGelClass 
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method 8: SOMObjectirsomGetCtassName 

method 9: SOMObject::somGetSize 

method 10: SOMObject:;somlsA 

method 11: SOMObject-somRespondsTo 

method 12: SOMObject::somls}nstanceOf 

method 13: SO MObje€t::sofn Dispatch 

method 14: SOMObject!:somClassDispatch 

method 15: SOMObject::somCastObj 

method 16; SOMObject::somResetObi 

method 17: SOMObject::somDumpSetf 

method 18: SOMObject::somPrintSelf 

method 19: SOMObject::somDumpSelflnt 

method 20: AtlribiJtes„som_Atlf:;SetProvenance 

method 21: Attribytes_som_Attr::SetTimeBeforePerish 

method 22: MTires_som_Ti res:: Brand New 

method 23: Generalltem_som_ltem::CalcTheATFnce 

method 24:6eneralltem_som_ltem::SetTheBTPrice 

method 25: Generalltem _som ltem::SetProductOrService 

method 26: Generalltem_somJtem::lnit]a[ize 

method 27: Generalltem_&omJtem::Uninitiatize 

method 28: GeneralJtem som ltem::SetltemDiscount 

method 29: MSolid„som_Soiid::SetQuant(ty 

method 30: MSolid_som_Solid::SetUnitPi1ce 

Conclusion 

St), if SOM i.s siK:h a great tcclintjkjgy, why isn't Apple 
using it for every little [>iece of soft win e distributed to either 
developers or end users’;' 

There are many good reasons. First, obje<^t-orienied 
programing is nt>l necessaiy everywhen*, tt Ls gtxxl for an 
appltailion or a complete ,s«)lution, liut mn always very interesting 
for system software, where encapsulation, |X)lyiiH)qihism ^yr 
inlieritance don’t always make sease. And if you're not using 
ol>ject-oriented prcigraming, then you're belter off using Ch'M 
(w!licit Apple is using for eveiy little piece of software) whicli 
provides a gcx)d dynamic lilirary architecture. But where OOP ckxcs 
rruike sense, as in Contextual Menus, then Apple ust^s SOM. 

Depending on w'hat youTe writing, you will fmd yourself in 
one (>f those cases; 


Table 1 

Development Strategy 


Kuntime 

Style 

Languagefs) 

Archlleeture 

Prtxedural 

C, Pascal, etc. 

CFM 

Native Objects 

C++ 

SOM 

X-Platform or Distributed 

Java 

Java 


Another reason is dial, unfortunately, there is a small price to 
pay to get the benefits of SOM. Although its dispatch ccxle (when 
you're railing a merh(xi which may or may not lx* overridden) is 
quite simll (6 PowerPC insintctions for a non-ovenidden nietliod, 
12 for an overridden method), it may Irad to perffsrmance issues 
if you have ttx) fine a granulartly (that means \lvdi rach melhcxl 
dtxs not do inuch, so ihe ratio of useful code and dispatch ccxle 


is not a gcxxl one). Typiolly, if you define classes wfiere methods 
do jobs as small as those I’ve si town in die examples of this article, 
then if you were to oveaise these objects (lei's say a billion call of 
SetQuantity and CaicTheATPrice)^ you might not get the expected 
performance, even on tlie fastest Power Macinto.sh, lliat being 
said, let’s not forget that if you’re using C++ classes, ifien you also 
[Ydy a price for methexi dispatch which is only marginally smaller 
than SOM's (1 PoweriC instruction for a non-virrual method, 6 for 
a virtual method). Furthermore, as my experience showetl, when 
defining utility cUsses, you define most of them as virtual (so dial 
you can override at your leisure later), although you override a 
small fraction of them in a particular project. In this t:ase, you get 
6 dispatc:h instructions for both C++ and 50M im[>lementation, and 
your cost is really 6 additic)nal in.stmctioas when you actually do 
an override in SQM. If your metliods (which may cxmiain loops, 
for instance) are thousands iastruoioas long at runtime, then die 
cost of using SOM insteacl of C++ is marginal. 


Table 2 

C++ versus SOM dispatc h code 


Case 

C++ 

SOM 

not overridded 

1 instruction 

6 insirucLums 

overrtddahle (virtual) 

6 Inst ructions 

6 instructions 

overridded 

6 instructions 

12 insifiiciions 


So the choice is Ix'tween non-OOP versus SOM Ixcause, if 
you're going to use OOP, then the advantages of SOM vs. C++ 
truly more tiian compensate llie very small amount of extra-time 
spent in the SOM dispaicli cotle vs, the C++ dispaicli ccxle. 

And, as a reminder, the advantages of SOM are: 

• language and Develoj^ment Environment independence 

• Shared Dynamit^ IJhraries and Object-Oriented Programing 

• Keeping the binary compaiibiliiy even wiien: 

Adding new meihcxls. 

Changing ilie size of an object by adding or deleting 
instance varialilcs, 

laserting new parent (base) classes afK)ve a class in the 
inheritance hierarthy, 

Rckxaiing methcMis upward In the class hierarchy 

• MuUhpiatfnnn (Mac OS, MS-Windows, OS/2, AIX, and 
many others...) 

Since you, readers, are more likely to develop applications 
t>r complete solutions than system software, then you should 
really think alxmt using SOM to lx)th clean up the past (with 
enc-apsulation) and provide for the future. 

Thanks to our techniol reviewers Deeje Ctxdey, Pete 
Gonlier, and George Warner. 

'Ihanks to our technical reineu^ers Brian Arnold, Paul Black 
Cmjf Clapp, Mike Rossetti and Jason Yeo. D 
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metro we rks 


CodeWanior for 



PalmPilot 

by Metrowerks 

CodeWamor for PalmPilot is 
the first complete set of tools 
which enables you to develop 
for the U.S. Robotics PalmPilot 
connected organizer, from the 
comfort of your PC or 
Macintosh computer. All the tools you need are included: the 
award-winning CodeWarrior IDE. compiler, linker, source-level 
debugger, GUI builder, and other tools, plus online 
documentation and reference materials. Includes one free 
product update and free technical support with registration. 


(SCWPALM) Our Price $369 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 



Latitude 

by Metrowerks 

Don't throw away the 
investment you have made 
in your Mac OS application! 

With the new DR2 release 
of CodeWarrior Latitude, you 
can now port your Mac OS 
application to Rhapsody, as 
well as Silicon Graphics IRIX 
and Sun Solaris. At the 
heart of Latitude is a set of shared libraries which performs the 
functions of the Macintosh API. You recompile your Mac OS source 
code, linking it with the Latitude libraries to produce a native 
application. As the Rhapsody API evolves, so will Latitude. 
Registered users of CodeWarrior Latitude will receive all developer 
releases, the first full release, plus one additional product update, 
to ensure that you have access to the most up-to-date Rhapsody 
porting tools available. 


(SCWLAl) Our Price $399 


Be 

OS 


CodeWarrior 
for BeOS 3 

by Metrowerks 



• Start programming for the new, innovative Be Operating 
System (BeOS) with complete set of Codewarrior toots 

• BeOS-native Integrated Development Environment (IDE) with all 
the familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax color 
and styling, and a source-level debugger 

• BeOS header and libraries, complete documentation, useful 
C++ classes, and sample code 

• Now includes Java support 

• The BeOS Preview Release allows you to run and program for 
the BeOS on a 603 or 604 PCI based PowerMac 


(SCWFB) Our Price $299 



MW Visual 
SourceSafe 
Release 5 

by Metrowerks 

• Source code control 
system, plug-in to the 
CodeWanior IDE or 
stand-alone Client application 

• Compatible with Microsoft Visual SourceSafe version 5.0 

• Cross-platfonn support (Mac, Windows, UNIX) 

• Configuration management in excess of 4 billion files 

• Over 8,000 files and sub-projects in a single sub-project 

• Registered users receive one year of free technical support 
and one free update 


(SMWVSS) Our Price $499 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 3 
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CodeWarrior 
Discover 
Programming 
Edition 

by Metrowerks 

• Learn to program in C/C++/Java/Pascal 

• Full-featured programming product-not a "lite" edition 

• Online books and tutorials 

• Hosted on either Mac OS or Windows 95/NT 
CodeWarrior Discover Programming Edition offers an unbeatable 
combination of full-featured programming tools, online books 
and instructional materials, all at a great price. Whether you 
want to learn the basics of programming or add a new language 
to your skill set. Discover Programming puts the information and 
tools you need at your fingertips: the award-winning, easy-to- 
use CodeWarrior Integrated Development Environment (IDE), 
tour of the most popular programming languages, online books, 
online tutorials, sample source code and free technical support 
(with your registration). Discover what you can learn with 
CodeWarrior, buy your copy today! 


BeOS Preview 
Release 2 

by Be, Inc. 

As the Internet spreads and 
electronic media becomes more 
prevalent, the high-performance 
needs Of digital content design and 
the complex, aging architectures of 
current mainstream operating 
systems are coming into conflict. The BeOS is the first operating 
system designed to unlock the door to much more powerful 
personal computers, and extract more performance from the 
systems we use today. 

(SBEOS) Our Price 

Macintosh Common Usp 4.0 

by Digitool, Inc. 

Macintosh Common Lisp provides users 
wito a rich set of object-oriented dynamic 
language features making it especially 
well-suited for rapid prototyping, custom 
development for business and education, 
scientific and engineering applications, and academic research. 

• Power PC native environment & compiler, full Macintosh support 



(SDPED) Our Price $79 
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• Includes Windows 95/NT and Mac OS versions of the 
CodeWarrior IDE 

• Supports C, C-r-h. Java and Pascal 

• Develop tor Windows 95/NT on x86 and Mac OS on 
68K/PowerPC 

• V2 Project Manager supports multiple open projects, subprojects, 
multiple targets per project, and threaded execution 

• Support for JDK 1.1.3 in CodeWarrior Java 

More platforms, more languages, more options: CodeWarrior 
Professional is designed to give you the tools you need for 
serious, industrial-strength programming. CodeWarrior 
Professional is the only Integrated Development Environment 
(IDE) in which you can edit, compile and debug C. C-i-t-, Java 
and Pascal programs for multiple target processors and 
operating systems. CodeWarrior's compilers produce fast, highly 
optimized code for Windows 95/NT running on x86, or Mac OS 
running on 68K or PowerPC processors. CodeWarrior 
Professional features the CodeWarrior IDE Version 2, The 
revamped Project Manager supports multiple projects open 
simultaneously, multiple targets per project, and threaded 
executon, and it's significantly faster. CodeWarrior Professional 
also includes online books, documentation, and reference 
materials, as well as tutorials and sample code. We support 
your development efforts with one free upifate and free world- 
class technical support for a year with registration. 

(SCWPRO) Our Price $449 


Order Tell-free 
800-MACDEV.I 


j800^22'338l| 


• CLOS, the standard Common Lisp object system 

• Interactive dynamic environment, multiple processes 

• Automatic memory management and self-typing data 

• Ephemeral garbage collector, smaller application footprint 

• Compiles with Common Lisp industry standard and smart 
programmable tools, 1 lO-i- mb of user contributed code 

• Complete on-line dxumentation (manual sold separately) 

• Soflware license and registration card 
(SMCLISP) Our Price $675 


1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 















MkUnux: Microkernel 
Linux 

for the Power Macintosh 

by Prime Time Freeware 

MkUnux is a native port of Mach 3 and 
the Linux 2.0 kernel, complemented by hundreds of commands 
from BSD, GNU, and X11, it runs on most (NuBus and PCi bus) 
Power Macintosh systems; Performa, PowerBook, and 
multiprocessor ports are currently under development. 

MkUnux is robust, powerful, freely distributable, and source code 
compatible with most other Linux systems. It provides a full suite 
of development tools, support for AppleTalk, HFS, and Objective- 
C, and access to a vast amount of free software. MkUnux is a 
great way to ‘come up to speed" on Mach, UNIX, and Rhapsody. 

• MkUnux user community supports FTP and web servers, 
development and porting efforts, and several mailing lists 

• The Apple sponsored reference release contains a wealth of 
introductory and reference material on Unux, Mach, NeXT, and 
the Power Macintosh 

• Includes free 3.0 upgrade 
(BMKUNUX) Our Price $49 


Order Tell'free 
800-MAC0EV-1 

|l»U2Mi| 


Pro Fortran 

by Absoft Corporation 

Absoft Pro Fortran combines native F90, VAX compatible F77, and 
(yC++ compilers into a single, easy to use environment. All compilers 
are link compatible and operate through a common interface. 

• Gr^hical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library, Absoft Create Make, several utilities, the 
latest version of MPW and illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data structures 

• Dynamic memory allocation and new control constructs 

• F90 is link compatible with Absoft F77, C-h-t, MrC and 
CodeWarrior 

• It is fully compatible with Toolbox, MPW tods, and most third- 
party products 

(SAPROF) Our Price $899 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


VIP-BASIC: 

Visual interactive 
Programming in BASIC 

by Mainstay 

Now you can create full-featured, stand-alone 

Macintosh and Power Macintosh applications in standard BASIC code! 

VIP-BASIC 2.0 is the fastest way to program your Macintosh, 

• Rapid application development environment with application 
framework, mix and match; VIP-BASiC high-level subprograms 

• Import pre-existing BASIC code; automatically integrate BASIC 
code, export C Code for compiling; automatically convert your 
BASiC code to C for compilation with Metrowerks' CodeWarrior 
(SVIPBASIC) Our Price $195 


VIP-C: 

Visual Interactive 
Programming in C 

by Mainstay 

Now you can create full-featured, stand¬ 
alone Macintosh and Power Macintosh applications in Just minutes. 
VIP-C 2.0 is the first rapid application development system for 
creating complete Macintosh programs in standard ANSI C. 

• Includes powerful, tightly integrated visual debugger. Import pre¬ 
existing C code: automatically integrate C code with a current project 

• Includes full-featured mini database: (ltd to 32K) of the powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-free, mutti-user database applications 

(SVIPC) Our Price $295 


SmalltalkAgents for Macintosh 

by Quasar Knowledge Systems, Inc. 

• An Integrated Development Environment (IDE) based on QKS 
Smalltalk. 

• “Live" direct manipulation of your objects 

• Dynamic, interactive and iterative development process 

• Easy and full access to the features of the Mac OS(tm) and Mac 
Toolbox 

• Link your non-Smalltalk code fragments with Code Fragment 
Manager (CFM) support 

• Cross-reference, access, view, and manipulate your code and 
objects with a sophisticated database for source code 
management 

• Includes an Application Delivery Tcolkit(tm) (ADT) that allows you 
to create royalty-free, standalone, double-clickable applications 
(SSTA) Our Price $395 
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ObjectMaster 
Professional Edition 

by Aitura Software, Inc. 

Object Master is an innovative programming environment that 
provides ail the necessary toois to write, organize, and navigate 
through source code. 

• Write code using the most robust source code editor available 
on the desktop 

• Organize source code into projects to quickly access and 
manipulate alt files 

• Navigate through source code using intuitive graphical 
Browser windows 

(SOMPE) Our Price $399 


M, ''TENON 

/r / / INTERSYSTEMS 

CodeBuilder 

by Tenon Intersystems 


CodeBuilder is a powerful and unique Macintosh software 
development tool for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 




Check out our Web site! 

Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


NS BASIC 3.e 
for the Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fuiiy interactive implementation 
of BASIC programming language 

• Runs entirety on the Newton - no 
host is required 

• Create files, access the built in soups, and the serial port for 
input and output 

• Work directly on the Newton, or through a connected Mac/PC 
and keyboard 

• Get the BASIC Internet Tool, available at no charge to NS BASIC users 
from www.nsbasic.com 

• Release Notes with sample code are available from the same location 

• Runs on any Newton MessagePad 130 with NS BASIC and the 
Newton Internet Enabler. Wso runs on MP 1201 s with NOS 2.0 that 
have full memory available 

• Write short programs to access News, mail and the web 
(SNSBASIC) Our Price $99 



• A powerful Macintosh software development tool suite of C, C++, 
Objective-C, Java, Ada, and Fortran development tools 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C, C++, Ada 95 and Fortran 77 

• Web & internet scripting tools: Peri, MacPerl, tcITtk, bash, sh, and csh 

• Supports Rhapsody kerne) W^ls and Rhapsody TCP sockets 
(SMIOCOOEB) Our Price $149 


Order Teil-free 
800-MACDEV-1 
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Here’s a list of all available products. For full product descriptions 
please see our Web site, or feel free to call, fax, or E-mail us. 

PRODUCT 

LPA MacProlog Developers Edition 
LPA MacProlog Programmers Edition 
LS Fortran Pro 
LS Fortran Plug-In 
Mac FORTRAN II 
Power MachTen-UNIX 
Presenting Magic Cap 
Think Pascal 4.0 


CODE 

OUR PRICE 

SLPAD 

995.00 

SLPAP 

495.00 

SLSFORT 

595.00 

SLSFPI 

199.00 

SFOFfra 

595.00 

SM10PPC 

695.00 

BPRESMAGiC 

15.25 

SPASCAL 

165.00 
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PowerKey Pro Model 200 

by Sophisticated Circuits 

PowerKey Pro Model 200 lets you start 
I up and shut down your Mac and up to 
five peripherals with a 
single keystroke. Two 
groups of switched 
outlets let you control 
I some peripherals 
separately. PowerKey 
also features phone 
I ring startup which 
' lets you access your 
Mac while on 
the road. 

Powerful scheduling 
features let you 
control your outlets with “hot keys" or 
perform tasks unattended, Start up your 
computer at any time of the day or night, 
open applications and run AppleScripts 
or QuicKeys. Add the optional Server 
Restart Option and you can even restart 
crashed servers automatically! 

System Requirements: Mac with ADB 
port, System 7 or later. Telephone 
features require analog phone line. 
(HPKEY2) Our Price $99 


PowerKey Pro Model 600 

by Sophisticated Circuits 

PowerKey Pro Model 600 is “the world's 
smartest power strip!" Start up and shut 
down your Mac and 
peripherals with a single 
keystroke. Includes six 
individually-switched 
outlets, with manual 
switches and indicator 
lights. Powerful 
scheduling features let 
you control outlets with 
“hot keys" or perform 
tasks unattended. Start 
up your computer at any 
time of the day or night, 
open applications and mn AppleScripts or 
QuicKeys. Complete telephone controllability 
lets you start up the computer, switch outlets 
or run complex events using custom touch- 
tone commands. For a limited time, Model 
600 includes the Server Restart Option, 
Restart crashed servers automatically! 

System Requirements: Mac with AOB port. 
System 7 or later. Telephone features 
require analog phone line, 

(HPKEY6) Our Price $199 




ObjectSet Mail SDK 

by Smailcode Software 

• Powerful C-i"i- classes for integrating 
Internet e-mail in your applications 

• Helps you write software that can share 
mail with other leading e-mail products 

• Royalty-free MIME, SMTP, and POP3 APIs 
for Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser 
and encoder available 

• Idea! for use in Internet and Intranet 
environments 

• Comes complete with samples with 
documented, reusable source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 



NetMinder Ethernet 

by Neon Software 

NetMinder Ethernet is a software-only 
protocol analyzer which captures and 
decodes a full range of Ethernet 
protocols including IP, AppleTalk, 
NetWare, NetBIOS and DECnet, 

Features include: 

• Sophisticated long-term monitoring 
with HTML output 

• Intuitive and powerful filtering 
capabilities 

• Automatic mapping of names to 
Ethernet, AppleTalk, and IP Addresses 

• Rules-based engine for detecting 
unusual network conditions 

• Customizable graphs for bandwidth 
utilization and packet rates 
(SNETMD) Our Price $715 



Memory Mine 

by Adianta, Inc. 

• Monitor heaps, identify problems such as 
memory leaks, and stress test applications 

• Active status of memory in a heap is 
sampled on the fly: allocation in non- 
relocatable (Ptr), relocatable (Handle) and 
free space is shown, as are heap corruption, 
fragmentation, and more 

• Allocate, Purge, Compact, and Zap memory 
lets users stress test all or part of a program 
(SMEMMINE) Our Price $99 


Future BASIC II 

by Staz Software 

FutureBASIC II is the award winning leader in Macintosh BASIC 
programming. 

• Source level debugger and Interactive compiler/editor 

• Multi-file Project manager and Multi-file find and replace 

• Super fast compilation, 32 bit clean, and System 7.x sawy 

• Quicl^ASIC converter 

• Getting Started manual with over 500 example files 

• Full support of standard B/^IC 
(SFBASIC2) Our Price $229 
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Visual MacStandardBasic 3.0 

by ZCurve Software 

Visual MacStandardBasic is the new standard for creating both 

68K and Power Macintosh applications. 

• Applications can be visually created in minutes 

• Visual controls such as command buttons, text boxes, list 
boxes, radio buttons, check boxes, scrollbars, icons, pictures 
and timers can be created and modified instantly 

• Use color graphics, animations, movies, sounds and speech 
in your programs 

• Console text window option helps converting older BASIC 
source code from other platforms 

• Online tutorial, manuals, sample projects get you programming quickly 

(SVMACSB) Our Price $29.95 


QC 

by Onyx Technology, Inc. 

High performance runtime stress testing for applications. 

• Tests include heap checks, purges, scrambles, 
handle/pointer validation, dispose/release checks, write to 
zero, de reference zero as well as other tests like free 
memory invalidation and block bounds checking 

• Extremely user friendly - ideal for non-programmer testers 

• Also available in Japanese 
(SQC) Our Price $99 





MacA&J) 


MacA&D 6.0 

by Excel Software 

• Structured analysis 
and design 

• Object-oriented 
analysis and design 

• Real-time and multi¬ 
task design 


• Data and screen modeling 

• Integrated code editing and browsing 

• Multi-user dictionary and requirements 

• Code to design diagrams for C. C-r+.etc. 

• Design diagrams to code for C, C++, etc. 

• State modeling diagrams and tables 

• Use cases with traceability 
(SMACADP) OurPrice $1995 


StoneTable 68K/PPC 

by StoneTablet Publishing 
StoneTable is a powerful and professional 
replacement for the List 
Manager used by developers worldwide. 
Version 3.0 is a new release with many 
Improvements Including better clipboard and 
drag/drop integration with other applications. 

• Available for use with CodeWarnor C & 
Pascal 

• Includes libraries for 68K (A4 & A5) and 
PowerPC 

• An LTabie-like class is provided to 
incorporate StoneTable Into the 
PowerPlant environment 
(SSTONEFAT) 0urPrice$199 



VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Stand-alone version control tool for all 
sorts of projects (software 
development, documentation, design, 
CAD, publishing, etc.) 

• Smooth integration with Metrowerks 
CodeWarrior and BBEdit. 

• Simple and clear management of variants 
and revisions of entire projects (not only 
of single files) 

• Easy-to-use graphical project browser gives 
access to all versions that were ever stored. 


iPOTLIQttT 


Spotlight 

by Onyx Technology, ln& 

Spotlight is a stand alone 
debugging aid that performs memory 
protection (arrays, heap accesses, outside 
your heap, iow mem, etc), discipline checking 
on toolbox calls, and leaks detection. 

• Spotlight is sold on an annual subscription 
basis 

• The subsciiption service provides all updates 

• Includes maintenance releases for one 
year after 

the initial purchase or renewal date. 
(SSPTLT) OurPrice $199 



Apprentice 7 

by Celestin Company 

Apprentice 7 is a high-quality CD-ROM 
collection of over 600 megabytes of up-to- 
date source code, utilities, and info for Mac 
programmers. All of the source code and 
utilities are completely new or updated for 
this release. 

• Frontier 4.1, the highly-acclaimed 
scripting environment 

• More PowerPlant AND many more 
PowerPC samples 

• Coot new languages and environments 
added (Clean, Eiffel, F, Tcl-Tk) 

• Ltot new demos from leading Mac 
development companies 
(SAPPRENT) OurPrice $35 


• Recording of the complete history (who 
made which changes when and why) 

• View differences between versions (not 
only for text fifes!) 

• Efficient delta storage of arbitrary files 
(text as well as non-text 

flies) gains savings of 95 % and more 

• Administration of users with hierarchical 
access rights 

• Configurable local file locking (Finder flag 
or 'ckid’ resource) 

• Scriptable, essential parts PowerPC native 
Single license (SV00D001) $229 

2 pack (SV00D002) $359 
5 pack (SV00D005) $799 
10pack(SV00D0010) $1369 
20pack(SVOOD0020) $2399 
Additional pricing available on request. 

SEE RELATED CATEGORY: Dev. Environments 


8 


1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 



















T! 

Be Basics 

by BeatWare 

Be Basics is the first productivity suite to 
combine ttie essentiai tools you use 
everyday with the incredibie power of the 
BeOS. Be Basics 

offers the BeOS developer the ability to: 

• Combine text, tables, graphs and pictures to create compelling 
documents 

• Work with multiple flies simultaneously without degrading performance 

• View all layout, style and content changes as they happen 

• Import Microsoft Excel files 

• Plug-in third party graphs and filters 

Be Basics requires the BeOS, 16 MB of RAM, 2 MB available hard 
disk space and a 256-color display adapter. 

Price includes all major and minor upgrades through version 2.0 via 
electronic distribution. 

(SBEBASIC) Our Price $69 

CodeBuilder /a. "TENON 

by Tenon Intersystems /rf/ intersvstems 

CodeBuilder is a powerful and unique Macintosh software 
developmont tool for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, C-n-, 
Objective-C, Java, Ada, and Fortran development tools. 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C, C++, Ada 95 and Fortran 77 

• Web & internet scripting tools: Perl, MacPerl, tet/tk, bash, sh, 
and esh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) 0urPrice$149 



Guide Composer" 1.2 

by StepUp Software 


STEP”” 1 

softwareI 


• Create powerful Apple Guide help systems for any new or existing 
Macintosh application 

• Provides a tWYSIVi/YG development environment: Guide content is 
developed in Guide windows 

• Design topics, phrases, and panels in the same format as the user 
will use them 

• Features are WYSIWYG interface. Topics, phrases, and 
hierarchical phrases, Coach marks, Fully-Integrated with Apple’s 
Guide Maker (distributed with Guide Composerj, compiles scripts 
automatically, PICTs in Panels, Generated Guide scripts are moditiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http://www,guideworks.com/ 

(SGCOMP) Our Price $99 


SEE RELATED PRODUCTS; AppleGuidu Complete, Danny Goodman's 
AppleGuide Starter Kit, Real World ApploGuidc 



B-ltee HELPER 2.2 

by Magreeable Software 

• Inexpensive database engine 
for Macintosh programmers 
in C source code 

• Uses contiguous fixed length 
blocks 

• Expands the file as necessary and contracts files when 
possible 

• Inserts and deletes keys in one or more B-Trees 

• Finds keys equal to, less than, or greater than a given value 
in a lew hundredths of a second 

• Finds lists of records whose keys are equal to, less than, or 
greater than a given value or are In a range of values 
(SBTREE) Our Price $149 



BBEdit 4.5 

by Bare Bones Software 

BBEdit 4.5 is a powerful, easy-to- 
leam text and HTML editor that 
offers developers and HTML 
authors the ability to build on its 
core functionality to suite their 
specific needs through its plug-in architecture and scripting 
capabilites. This new version includes; a visual table tool that 
speeds page and site development, contextual menu support for 
Mac OS 8, improved storage for 'grep' patterns, scriptabie HTML 
authoring preferences and more. It still provides: unparalleled 
searching muscle with support for both 'grep' style and advanced 
literal searches, the ability to quickly compare differences 
between files or entire folders, integrated support for Symantec’s 
IDE, Metrowerks CodeWarrior, THINK Reference 2,x, MPW 
Toolserver and most other environments and a heck of a lot more. 
(SBBEOIT) Our Price $119 
Also see Internet Related, page 12 


Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer “atoms” that let developers incorporate 
graphics, sounds, file compression and custom folder icons into 
installation scripts 

• Compression formats supported are Compact Pro & Diamond 

• Each atom also available separately 

• Compression requires additional licensing 
(SINSTALL) 0urPrice$219 

ScriptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp’s InstallerPack, Stuffit decompression. Compact 
Pro decompression, custom packages, splash screens, network 
installs, and resource Installation 

(SSCRPTGEN) Our Price $169 


Web site: http://www.devdepot.com • E-maii: orders@devdepot.com 
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BeSpecific 3 

(Third in a series) 

by Adamation 

The best-selling BeSpecific CDROM series 
provides the best in BeOS 
shareware across a wide range of 
application areas, including: 

• Productivity programs • Latest source code 

• Programming tools • Graphics Games 

• Commercial demos 

Newsgroup archives {comp.sys.be) Developer mailing list (Be DevTalk) 
BeSpecific 3 is brimming with useful BeOS Preview Release-compatible 
software. A "must have" companion for all users of the BeOS. 
(SBESPEC) Our Price $39 



Pilot Attache Diski 

(First in a regular series) _ . 

by Adamation 

The Pilot Attache CDROM, designed for*the 
popular US Robotics Palm Pilot organizer 
provides you the best in Pilot shareware. 

Extend your Pilot’s capabilities across a 
wide range of application areas, including; 

• Personal productivity tools • Newsgroup information 

• Programming tools • Games 

• Utilities 

Fully tested, Pilot Attache's shareware treasure throve will help you 
get the most out of your Palm Pilot. When you travel with your Pilot, 
don't forget your Attache. Pilot Attache...your passport to success. 
(SPATCHE) Our Price $29 


\^t^s Edge Software 



Tools Plus libraries + 
framework 

by Water’s Edge Software 

Easily create compact, fast running, 
professional looking applications and plug-ins*. 
Tools Plus lets you create virtually any user 
Interface element with a single routine, and it 
transparently provides a robust infrastmcture to 
make all your pieces work together as an 
application. 

• Simplifies programming and thins source 
code 

• Automates all standard GUI elements 

• Thousands of extras, from floating palettes 
and tool bars to powerful picture buttons 

• Includes numerous 3D grayscale options 


• Over 1/2 MB of custom fonts, icons, 
cursors, and other resources 

• Includes SuperCDEFs world-class controls 
(an $89 value) free 

(STOOLCW) Our Price $249 

CodeWarrior Gold 

(C/C4-t- & Pascal, 68K & PPG) 

(STOOLCWB) Our Price $199 
CodeWarrior Bronze (C/C+ + & Pascal, 68K) 

(STOOLSYMTl OurPrice$199 
Symantec (THINK) C/C++ and THINK 
Pascal (68K) 

(STOOLSYM) Our Price $149 
Symantec (THINK) C/C++ (68K) 

(STOOLPAS) Our Price $149 
THINK Pascal (68K) 

'CodeWarrior required to write plug-ins 


AppMaker 

by Bowers Development 

• Develop the user interface for a Macintosh application 
using the original interface builder 

• Just point and click to design your application 

• Creates resources and generates excellent source code 

• Supports most development environments including 
Melrowerks, Symantec, or MPW; C, C++, or Pascal; 
procedural or object-oriented, using PowerPlant, TCL, 
or MacApp 

• The generated code uses the Universal Headers to provide PowerMac compatibility 

• Great tool for beginners to learn object-oriented and Macintosh Toolbox programming 
techniques 

• Includes one-year subscription on CD and hardcopy documentation 
(SAPPMAKE) Our Price $199 
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TesfTrack-Bug Itacking 
the Macintosh Way 

by Seapine Software, Inc, 

• Tracks bugs, feature requests, test 
configurations, users, and more 

• Includes notifications, security, a 
powerful fitter mechanism, and 
multiple reports 

• Links your testers, engineers, 
documentations staff, and project 
managers together to ensure all bugs 
are identified, fixed, and documented 

• Eliminates the need to build custom 
bug tracking solutions using general 
purpose database tools 

• Supports single- and multi-user bug 
databases (additional licenses 
required to use multi-user features) 
(STETR) Our Price $129 
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SuperAnalyst 

by SuperSoft 

SuperAnalyst is an 
easy-to-use data 
analysis and plotting 
application written 
specifically for the 
Apple Macintosh 
computer and 
PowerPC, it provides a 
wide range of X-Y plotting and analysis capabilities at a click of the 
mouse. It is easy to use and provides interactive control of the 
appearance of almost every characteristic of your plot. You can 
overlay multiple plots on the same graph, and the number of 
points is limited only by the memory of you computer. 

• 16 Plot Ty^es: Scatter (Box and Cross), Line (with and without 
symbols), Function, Log-Log, Semi-Log, Double Y, Bars, 

Columns, Stacked Bars, Stacked Columns, Area, Pie, Polar, and 
Histogram. 

• Function Plots: Plot mathematical equations you can input 
without constant reference to the manual. 24 intrinsic functions 
(cos, sinh, exp, In, sqrt, erf, bes, gam, etc.), 

• PLUS, set templates, reads many file formats, smooth, filter, and 
sort data, modify data, error bars, function and data integration, 
FFT tranforms, curve fits, etc. 

(SSANAL) Our Price $99 



SuperPlot 

by SuperSoft 

SuperPlot is a plotting library which can 
be linked and called directly from 
programs written in either Fortran, 

Pascal, or C, SuperPlot provides a 
simple way to plot data generated by your program, edit ttie plot, and 
then print, export, and/or save the plot for future reference. 

A simple subroutine or procedure cdl hides your applications menu 
bar, puts up SuperPlot’s menu bar, creates a new window, and plots 
your data, It provides you with complete control of the appearance of 
your plot using the mouse, menus, floating palettes and dialogs. 
Preparing presentation quality graphs of your data was never easier. 
SuperPlot runs on either the PowerPC or 68 K computers. 

(SSPLOT) Our Price $195 



SuperPlotPRO 

by SuperSoft 

• Plotting data from your program was never easier 

• A Plotting and Chart Library callable from Fortran, Pascal, and C 

• Plot Types: Scatter, log-log, x semi-log, y semi-log, Ddouble Y, 
cross, line, line w/ symbols, bar, stacked bar, column, stacked 
column, area, pie, polar 

(SSPLOTPRO) Our Price $295 


QUED/M 3.0 

by Nisus Software 

• The programmer’s text editor tiat defined the 
industry standard for speed and efficiency 

• PowerPC native 

• Features integrated support for Symantec 
C/C++, Metrowerks CodeWarrior 6, and MPW 

• Supports all the major development environments on the Macintosh, 

• Powerful editing features, including unlimited undo and redo, macro 
language, scripting, text folding, ten editable/appendable clipboards, 
markers, displaying text as ASCII codes, dynamic coloring of C/C++ 
keywords/comments, rectangular and non-contiguous selection 

• Includes Celestin Company's APPREMTICE 4 
(SQUEDM) Our Price $89 


AG Author 

by Lakewood Software 

AG Author 1.0 is a full-featured Apple Guide authoring tool with 
fully customizable project template. The following features are 
unique to AG Author: 

• Support for styled, colored, & hot text 

• Fully customizable project template 

• Flexible compile options 

• Find & replace tool for scripts 

• Multiple open projects 

• Rapid deployment of project globals 
(SAGA) Our Price $99 

SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman's 
AppieGuide St^er Kit, Real World AppleGuide 



Web Ware 

by BeachWare, Inc. 

The ultimate collection of olip media and 
templates for Puilding your own Web Page, 
incredible selection of Shockwave movies, 
animated GIFs, buttons, bullets, dividers, and 
sample HTML pages. There are literally thousands of graphical elements 
on this disc, ail there to spice up your web page. In all, it's about 300 
megabytes of creativity only a mouse-click away! System Requirements: 
PC - 486 or better with 8 MB RAM, Sound card, SuperVGA, CD-ROM 
drive, Macintosh - Color Mac with 8 MB RAM, CD-ROM drive. 

(SWEBW) Our Price $24 


SoftPolish CD-ROM 

by Bare Bones Software 

• The essential tool for software quality 
assurance on the Macintosh 

• Helps you identify inconsistencies with 
Apple's user interface guidelines, 
misspelled words, missing resources, 
and other mistakes 

• Provides tools to put the finishing touches on software distribution 
packages prior to release 

• Work.? independently of any programming language or environment 

• ideal for sanity checking software throughout the development process 
(SSOFTPOL) Our price $99 
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VText 

by Vivistar 

VText is a C++ add-on library for 
MetrowerKs’ PowerPlant application 
framework. VText provides complete 
Macintosh text support including: greater 
than 32kb text, undo, drag and drop editing, 
AppteEvent scripting and recordability, full 
support for multibyte characters and inline 
input methods including Japanese and Chinese text, and full support 
for bi-directional script systems including Arabic and Hebrew. 

• Full featured text engine for Metrowerks' PowerPlant 

• Stylesets and rulersets with tabs 

• Flexible object oriented C++ API 

• Full undo and drag and drop editing 

• WorldScript savvy including bidirectional and multibyte scripts with 
inline editing 

■ AppleFvent factored for scriptability and recordability 
(SVTEXT} Our Price $349 



OpenGL for 
the Macintosh 

by Conix Graphics 




OpenGL is the premier 3D graphics library that allows software 
developers the ability to develop high-quality, interactive 2D and 3D 
graphics applications. OpenGL can perform the following wide range of 
functions which will enhance the development of all graphics software; 

• Geometric primitives (points, lines, and polygons) 

• RGBA or color Index mode 

• Viewing and modeling transformations 

• Texture Mapping, Lighting, Shading and 1 Buffering 

• Atmospheric Effects (fog. smoke, and haze) 

• Alpha Blending (transparency) 

• Antialiasing, Accumulation Buffer. Stencil Planes 

• Display list or immediate mode 

• Polynomial Evaluators (to support Non-uniform rational B-spiines) 

• Feedback, Selection, and Picking Raster primitives (bitmaps and 
pixel rectangles) 

• Pixel Operations (storing, transfomiing, mapping, zooming) 
(SOPENGL) Our Price $389 


diF 

EtherPeek 
Fortran 77 SDK 
ICONIX PowerTools-6 Pack 
ICONIX PowerTools-8 Pack 
ICONIX PowerTools-10 Pack 
ICONIX PowerToc&AdaElow 
ICONIX PowerToots-ASCll Bridge 
ICONIX PowerTools-CoCoPro 
ICONIX PowerToots-OalaModeler 
ICONIX PowerToots-FastTask 
ICONIX PowerTools-FreeFlow 
ICONIX PowerTools-Object Modeler 
ICONIX PowerTools-PowerPDL 
ICONIX PowerToolS'QuickChart 
ICONIX PowerTools-SmartChad 
ICONIX Training & Consulting 
IMSL Math and Stat Library 
Inlo-Mac X 

Ionizer Real-Time Spectral Reshaping Tool 
LiveAccess™ 1 User Edition 
LiveAccess™ 1 Developer Edition 
LiveCard 
LJ Profiler 

MacFlow'': Flowchart Design and Development 
Mac Source II 
Nisus Writer 5.0 

Plan & Track™; Project Planning and Management 

Phyla™: Object-Oriented Database 

r-tree Report Generator 

Spetlswell Plus 2.1 

Spyer 

Visual Cafe 


CODE 

OUR PRICE 

SBEEONE 

$139.00 

SCTPDH 

$895.00 

SCOMPIT 

$149.00 

SCPU2X 

$79.00 

SDWORKS 

$995.00 

SDTF 

$695.00 

SEPEEK 

$745.00 

SF77 

$699.00 

SICPP6 

$5,945.00 

SICPP0 

$6,945.00 

SICPP10 

$7,845.00 

SICADA 

$1,395.00 

SICASCII 

$1,395.00 

SICCOCO 

$1,395.00 

SICDATAMOD 

$1,395.00 

SICFASTTASK 

$1,395.00 

SICFREEFL 

$1,395.00 

StCOBJMOD 

$1,395.00 

SfCPOWER 

$1,395.00 

SICQUICKCH 

$1,395.00 

SICSMART 

$1,395.00 

TICOMIX 

$2,945.00 

SIMSLSTAT 

$495.00 

SINFOJVIAC10 

$39.00 

SIONIZER 

$800.00 

SLAUE 

$69.00 

SLADE 

$99.00 

SLCARD 

$149.00 

SUPROF 

$295.00 

SMACFLO 

$179.00 

SIVIACSOURCE 

$29.95 

SNISUSW 

$220.00 

SPLf^IBK 

$179.00 

SPHYLA 

$179.00 

SRTRG 

$445.00 

SSPELL 

$49.00 

SSPY 

$39.00 

SVCAFEMAC 

$199.00 



Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT 

Bee one 

C tree Plus® Database Handler 
Compilell! 

CPU Doubler 
DesignWorks 4.0 


12 1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 


























Check out our Web site! 

Full product descriptions • Hundreds of more products 
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PageCharmer: Sizzling Effects... 




WebTen 

by Tenon 
Intersystems 
WebTen is an 
industrial-strength, 
high-performance 
Apache Web server for 
Power Macs. WebTen’s Web-based browser interface enables local or 
remote administration via your favorite browser. Since Apple’s NeXT 
acquistion. Tenon has extended their unique "UNIX virtual machine" 
technology to produce a set of “Rhapsody-Ready" internet 
applications. WebTen is the first offenng in this series. 

• WebTen is fhe fastest Web server on Power Macintosh 

• Sustains up to 10.000 connections a minute, or over 10 million 
connections a day 

• Apache runs in Tenon’s multi-threaded, pre-emptive 
multitasking environment 

• Tenon’s unique technology supports the widely acclaimed Apache 
Web server as a double-clickable MacinhKh application 
(SWEBTEN) Our Price $495 


_ 


webAlias 1.0 

by Lakewood Software 



webAlias 1.0 is an 
integrated image map 
editor and anti aliasing 
text tool for web and 
graphic designers. Use 
webAlias to create 
complete web sites, 
single web pages, and graphic content for multimedia and web 
design projects. webAlias integrates support for line, shape, free 
form, field and button objects. webAlias' anti-aliasing features 
include support for embedded pictures and gradients in text, as well 
as multiple shadow and highlight effects. 

(SWEBALS) 0urPrice$129 


PageCharmer 1.0 

by Mainstay 

PageCharmer is a set of customizable interactive applets that 
enhance web pages without writing a single line of HTML code. 
Whether the web site is already up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated applets that can be 
personalized to fit most any need. 

FEATURES: 

LiveG-Map, LiveT-Map. LiveG-Button, LivcT-Button, LiveGT-Button, 
LiveG-Tlcker, LiveT-Ticker, UveG-Marquee, and LiveT-Marquee. 
(SPGCHRM) Our Price $99 



BBEdit4.5 

by Bare Bones Software 
(SBBEDIT) 0urPrice$119 

Also see Tools, Libraries and 
Utilities, page 8 









HyperGuide 1.0 

by Lakewood Software 

HyperGuide f .0 Is a 
hybrid multimedia 
authoring tool and on-line 
documentation system for 
the Macintosh and World 
Wide Web. HyperGuide 
provides integrated 
searching, indexing and 
bookmarking features. 

Supported media elements include: rectangle and scrolling fields, 
lines and shape fills, most QuickTime-supported image formats, 
anti-aliased text and QuickTime VR movies. HyperGuide also 
includes an integrated screen capture utility and user-configurable 
slide show mode. 

(SHYPGUD) Our Price $149 
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Web site: http://www.devdepot,com 


E-mail: orders@devdepot.com 
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ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C++ classes for integrating 
Internet e-mail in your applications 

• Helps you write software that can share 
mail with other leading e-mail products 

• Royalty-free MIME. SMTP, and POP3 APIs 
for Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 



Power MachTen 4.0.3 

by Tenon Intersystems 

MachTen is the only Macintosh product that can turn your 

Macintosh into a complete Unix workstation. Based on 

BSD4.4 and the Mach kernel, MachTen brings the power 

of Unix to your desktop at an extremely attractive price point. 

MachTen enables you to; 

• Run a high speed internet server, complete with WWW, FTP, NFS, 
DNS and print service 

• Build a Mutihomed Web Server 

• Develop applications in a Unix development environment, replete 
with the acclaimed GNU development toolset 

• Program in Ada. C, C++, Pascal. Fortran, and more 

• Run Xwindows applications, from remote workstations or on 
your Macintosh 

• Run hundreds of Unix applications, already ported for MachTen 
and available on our Ported Applications CD-ROM 

• Run Software.com Inc's acclaimed Post-Office mail transport service 
(SM10PPC) Our Price $695 



Rumpus 

by Maxum Development 

Maxum's new. high- 
performance FTP senrer for 
the MacOS. Based on 
Maxum’s RushHour TCP/IP implementation. Rumpus 1.0.1 offers 
the performance and reliability of high-end workstations with the 
ease of use, security, and flexibility of the Macintosh. 

• Simplified setup, with no need to configure AppleShare, File 
Sharing, or Users & Groups for simple anonymous FTP 

• Anonymous and/or secure server access, with separate 
security settings tor anonymous vs. secure users 

• Automatic MacBinary and Binhex encoding 

• Complete logging, with separate anonymous and secure 
access logs, including anonymous user passwords 

• Up to 32 simultaneous connections 
(SRUMP} Our Price $195 








i. Ihrf Wtn 

j r 1 

|i cviTHt nr 1^ 41^ 

K (.MlJIaMTav 



1 




CGiTooIkH 

by Pictorius, Inc. 

The Pictorius CGi Toolkit is the fast and 
easy route to high performance CGIs 
and ACGIs for your Mac Web site. 

•Interactively develop CGIs while the 
web server, the CGI Toolkit and the browser are running on the 
same machine 

‘ Interactively develop, test and debug CGIs before compiling 
' Powerful debugger allows you to edit code, roll back, code and 
change input values while your application is running 
' Fully object oriented so you can re-use your code 
' Automatic handling of Apple Events so you can concentrate on 
building functionality 

' Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 
(SCGITLKT) 0urPrice$149 





Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

OOFILE Reporter Writer 

ScriptDemon 

WebSiphon 


CODE OUR PRICE 

SOORW $499.00 

SSDEMON $949.00 

SWSIPHON $495.00 
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WindowScript 

by Royal Software, Inc. 

WincSowScript is the ultimate tool for designing Macintosh user 
interfaces using HyperCard. Design Real "Macintosh" user- 
interfaces right inside HyperCard. Until now you either created 
HyperCard stacks or Macintosh applications. With WindowScript 
you can literally bring the look and feel of a real Macintosh user- 
interface to HyperCard. If you're a HyperCard developer, interface 
designer, application develqjer, program manager or tester 
searching for a prototyping tool, WindowScript is perfect for the Job. 
(SWSCRIPT) Our Price $149 


Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most from 
AppleScript! 

• Advanced debugging environment offers 
single-step script execution with 
breakpoints 

• Script Debugger dictionary browser 
features a graphical view of objects 
provided by scriptable applications 

• Includes Late Night Software Scripting Additions - a collection of 
more than 70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 
(SDEBUG) Our Price $129 


Scripter 2.0 

by Main Event Software 

For professionals, for novices, for 
webmasters, for solutions providers, there's 
only one serious choice, Scripter! 

• Scripter and FaceSpan work together: one 
click opens your FaceSpan script in 
Scripter, another sends it back 

• Debug handlers without modifying your scripts using the Call Box 

• Applet simulation, live editing, Object map, associated terminology 

• Search backwards, biwk generators, more navigation shortcuts, 
more drad-and-drop, and an even more enhanced trace log 

• Now Includes ScriptBase; stores your data and media elements 
and share them between scripts all with a special new browser 

• Easily write and compile scripts that have handler declarations 
and other vocabulary speciflc to a particular scriptable application 

• Scripter is the natural companion to AppleScript for users at all 
levels of proficiency. Don’t write scripts without it! 

(SSCRIPTER) Our Price $199 





FaceSpan v3.0 

by Digital Technology International 

FaceSpan is a cutting edge interface 
design and rapid application development 
(RAD) tool v^ich gives you the power to 
build and customize Macintosh 
applications quickly and easily. 

• Acts as your front end for AppleScript or any other OSA (Open 
Scripting Architecture} language. 

• Allows you to automate often-repeated tasks, customize and 
integrate existing applications, build new applications and 
personalize your computing environment. 

• NFW! Allows you to create interfaces and applications that 
conform to the Mac OS 8 look and feel. 

• NEW! Supported display objects now include tab panels, 
disclosure triangles, bevel buttons and more. 

• NEW! FaceSpan run-time now launches up to 5X faster. 

• Includes an unlimited, royalty-free distribution license for the 
interfaces and applications you create. 

(SFACESPAN) Our Price $149 



TCP/IP Scripting Addition 

by Mango Tree Software 
•Award-winning AppleScript scripting 
addition 

•Allows you to write scripts using 
MacTCP"^” commands in AppieScripL^“ 
• Send e-mail or flies through a script, 
check if users are logged on (via Finger), automate FP, Gopher, 
NetNews, Telnet, and LPR, verify links in HTML documents, and 
quicWy write many other TCP/IP client-server programs 
• Works with AppleScript, MacTCP 2.0.4 and Open Transport 
(STCP) Our Price $49 
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DynaMorpli 1.5 

by Morph 



DynaMorph is the only cross-platform, server-side scripting language. 
Easily build and maintain dynamic w^sites arto web-based 
applications. Access external databases, separate the format of a 
website from its content, conduct e-commerce toansacflons and 
more. DynaMorph makes sites and applications completely portable. 
(SDYNA) Our Price $399 




Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT CODE OUR PRICE 

PreFab Player SPlJtYER $95.00 
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ClipVR” 

by eVox Productions 

Clip VR** is a new digital image library offering high Quality 
Photographic Virtual Reality (PVR) images for use with Quicktime® VR 
and other desktop VR tools. 

Qip VR" Panoramic Image components include alpha channel masks. 
(Combine elements into a composite panorama which is converted to 
the finished QuickTime VR movie using Make QTVR Panorama Tool. The 
Components ("Clips") include complete 360 degree scenes, libraries 
of 360 degree terrains, 360 degree skies, buildings, and objects. 
Images are provided as .PICT files AND QuickTime VR movie files. 

Clip VR^'^ allows you to create high quality VR worlds from pre¬ 
photographed component images. Clip VR'” can be used to add 
excitement to a web site, to increase the interactive value of a CD- 
ROM, or simply for fun! Requires imaging editing program such as 
Adobe Photoshop" to perform .PICT image compositing. 

(SCLIPVR) Our Price $89 


Screen Machine 

by BeachWare, Inc. 

Personalize your computer xreen 
with this dynamic and useful 
collection of Screensavers and 
Wallpapers. Choose from over 
too original Screensavers such 
as flying airplanes, bouncing 
coffee cups, falling climbing gear, 
shifting psychedelic patterns, or 
floating spaceships. Customize your computer desktop with over 
150 exciting new wallpapers such as sand, rocks, cloth, coins, 
cartoons, or unique patterns. Included is an easy to use browser 
program that lets you sample all of the Screensavers and 
Wallpapers before installing them on your computer. 

(SSM) Our Price $24.95 



AudioTrack 

by WAVES 

AudioTrack is a software plug-in for native 
processing on digital audio recording and 
editing systems. Waves AudioTrack combines 
the most-needed audio processors into a 
single piece of software, including 4 bands of equalization, 
compression/expansion, and noise gating. AudioTrack is ideal for 
preparing audio for InterNet streaming formats, processing individual 
mono/stereo tracks of audio and audio for video editing systems 
including digital sequencers. 

Feature list 

• A single window interface 

• 4-band ParaGraphic Equalizer, Compressor/Expander and Gate 

• Instantaneous A/B comparisons of on-line settings 

• Pretested setup libraries supplied for various processing solutions 

• Power Macintosh native processing (requiring no DSP board) 

• Volume and gain reduction meters 

• Peak hold and clip meters 

Requirements: 

The AudioTrack is compatible with all machines supported by Deck II, 
SoundEdit 16, Adobe Premiere 4.0 and Cubase VST 3.1 
(SAUDIOTRK) Our Price $270 



Captivate 4.6: 

Essential Graphics Utilities 

by Mainstay 

Captivate^” 4.6 is a powerful collection o( 
graphics utilities for Macintosh, based on 
Mainstay’s acclaimed screen capture utility, 
graphics and multimedia xrapbook, and 
graphics viewer. Captivate provides essential graphics utilities to the 
professional and hobbyist alike. 

• Package Includes: Captivate Select, Captivate View, and Captivate Store 

• Any one of the three can be used alone, and together they make 
an unbeatable team 

• Whether writing a training manual, creating an ad, or just creating 
a startup screen from your favorite picture. Captivate is everything 
professionals need at a price anyone can afford. 

(SCAPTIV) Our Price $79 
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Media Cleaner Pro 

by Terran Interactive 
Use Media Cleaner Pro 2.0 to optimize and 
compress video for CD-ROM, kiosk, or the 
Internet. Media Cleaner Pro automates your 
work flow allowing you to get the highest 
quality video, faster and easier than any 
other program on the market. 

• Includes Adobe Premiere Export module 


• Optimal palette generation. Drag-and-drop 
batch processing 

• RealMedia, VDOLive and improved 
QuickTime support 

• Dynamic Preview Window, the Media 
Wizard, multiprocessor support and more! 

System Requirements: 

68040 Mac or better (PowerPC strongly 
recommended, req'd for RealMedia), 


QuickTime 2.0 or later (2.5 strongly 
recommended) 

8 Mb application RAM, MacOS 7.0.1 (7.5 or 
later recommended) 

SoundManager 3.2, CD-ROM Drive 
(SMCP) 0urPrice$359 
Registered owners of Movie Cleaner Pro 1.3 
or earlier can upgrade 
(SMCPUP) Our Price $129 
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Magellan QC 

by Kaidan 

The Magellan QC is capable of 
handling objects as large as six 
inches in diameter and five 
pounds in weight, the Magellan 
QC is the perfect choice for 
those needing to capture 
smail objects at a 
reasonabie price, Real- 
I world objects can be 
turned into 3-D virtual 
reaiity movies using the 
QuickTime VR Authoring 
Studio and the Magelian QC. 

The Magelian QC ievenages the capabiiities of 
the Connectix" Coior QuickCam" digital camera for QTVR object 
capture. Ttie Color QuickCam’s ciose focusing capability (one inch 
to infinity), 840 x 480 resolution, seriai interface (no video card 
required), 24-bit coior support, convenient size and tow cost make it 
an ideal camera for many simple QTVR object movies. Using the 
Magellan QC is easy. Simply locate the object on top of the 
adjustable pedestal, perhaps with a small piece of double-sticky 
tape, and then adjust the arms and pedestal so that the center of 
the object is centered in line with the camera and the rotation axis 
of the swingarm. 

(HMAGQC) Our Price $299 


Magellan Accessories 


Magellan QC Pedestal Set 

Two extra pedestal tube assemblies, one 2.5" and another 6" 
long. These extra pedestal tubes are used to support objects of 
varying sizes on the Magellan QC. 

(HMAGPED) Our Price $39 

Magellan QC Detent Wheels 

A pair of optional detent wheels (Color = Gold) with 8 (45 
deg), 12 (30 deg), 14 (25.7 deg), 16 (22.5 deg) and 18 (20 
deg) settings. The standard wheels (Color = Aqua) provide 10, 
15,20,24 and 36 positions. 

(HMDWHLS) Our Price $74 



The QuicW’an Magnum Series consists of two models, the QPX- 
1 and QPX-2. Featured on both models is the new QPLI-2 i 

camera bracket, Based on the highly successful KiWi, if provides 
a sturdy, collapsible system for the mounting and adjusting of a 
wide variety of cameras and camcorders. The new base designs j 

used on the Magnums are a refinement of our earlier bases, t 

with the QPX-1 having a fixed base and the QPX-2 having a new 
low-profile micro-tilt adjustment stage. The easily adjustable ■ 
click-stops will let you capture a panorama in a few seconds. 

The QPU-2 has two accessories, a Landscape Bracket for 
positioning the camera in the landscape orientation (OPLB-1) 
and a Counterweighting Kit (QPCW-1) used to balance large 
cameras or camcorders, such as the Sony VX-1000, that have a 
center of mass well behind the pivot axis. 

QuickPan Magnum-1 (HQPMAGI) Our Price $499 
QuickPan Ma9num-2 (HQPMAG2) Our Price $549 


QuickPan Magnum Accessories 


Counterweighting Kit 

The Counterweighting Kit includes a weight and adjustable arm 
that is used to offset the weight of large, heavy cameras and 
camcorders, 

(HWKTKT) 0urPrice$129 

Detent Wheel 

Detent Wheel (5-inch) (Color = Purple): 10,14,18,24 and 30 
Position (QPDD-2) 

(HQDWHLS) Our Price $49 

QuickTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2, that mounts between your panhead or camera 
and your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number of 
QTVflAfR nodes in a short period of time, 

(HQTLVLR) Our Price $149 


Web site: http://www.clevdepot.com • E-mail: orders@devdepot.com 
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KiWi 

by Kaidan 

The KiWi™ 
is the most 
affordable VR/QTVR 
panhead, bringing digital 
photographic panoramas 
to an even wider audience. 

It's the perfect companion to 
programs such as QuickTime VR Authoring Studio, PhotoVista and 
Nodester, providing a complete solution for anyone interested in 
adding VR panos to their websites and multimedia applications. 

The KiWi™ consists of two intersecting black anodized aluminum 
struts that adjust and lock to accommodate a wide range of 
cameras, such as the Apple QuIckTake 100/150/200, Kodak 
DC50/120, APS film cameras and 35mm SLRs equipped with wide- 
angle lenses. KiWi™ attaches to any standard tripod and camera 
equipped with a standard 1/4-20 mounting thread. 

(HKIWI) Our Price $99 




by Kaidan 

The KiWi-e adds a compact, yet durable click-stop mechanism 
and the same twin-axis bubble level found on the top-of-the-tlne 
QuickPan Magnum Series heads. The twin-axis bubble level 
(recommended by Apple and VR professionals) provides a clear 
indication of level, even when the unit is slightly above eye level. 
The click-stop mechanism uses easily replaceable detent discs, 
which are available in a number of positions (8.12,16.18,20). 
The KiWi-t- ships with one disc of your choice and extra discs are 
available separately or as a set, The click-stops speed the 
process of shooting a panorama by eliminating the need for the 
photographer to look at the unit in order to visually align the 
index increment. 

(HKIWiP) Our Price $249 


KiWi and KiWi+ Accessories 


QuickTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2, that mounts between your KiWi or KiWi-t- and 
your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number of QTVR/VR 
nodes in a short period of time. 

(HQTLVLR) Our Price $149 

KiWi-to-KiWi+ Upgrade 

Includes the necessary parte required to turn your KiWi into a 
KiWi+ — adding click-stops and the twin-axis bubble level. Comes 
with a detent disc of your choice (8,12.16.18 or 20 positions). 
(HKiWIUP) 0urPrice$199 

KiWi+ Detent Discs 

KiWI-t- Detent Discs are available singly or in a set of four. In both 
cases you get to choose whichever discs you need. 

(HDTDISC) Our Price $24.95 each 

(HDTDISC4} Our Price $89 set of four 

Choices include: 8,12,16 ,18, or 20 position detent disc 


Landscape Bracket 

The Landscape Bracket is a right angle bracket that allowrs you to 
mount the KIWi or KiWI+ upright camera bracket in a horizontal 
orientation. This bracket is primarily used for cameras that have a 
limited field of view and you need to limit the number of shots. 
(HLDBRAC) Our Price $42 

Flash Hotshoe Level 

A dual-axis bubble level that slictes into your camera’s hotshoe. It’s a 
useful tool to help level the camera on the upright camera bracket. 
(HFLASH) Our Price $39 

Offset Spacer 

The Offset Spacer is a circular spacer that may be required for 
very narrow cameras (i.e. certain Ricoh digital cameras) in order 
to position the center of the lens over the pivot axis. 

(HOFFSPAC) Our Price $24.95 
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Be Studio 

by BeatWare 

Developed specifically for the 
BeOS, Be Studio is the first 
graphics application to offer 
full multithreading for 
unbelievable responsiveness 
and unbeatable speed. Be 
Studio includes Paint for 
editing photos or creating 
original artwork and Draw, a 
vector-based tool for 
drawing crisp designs and prints. Be Studio offers the BeOS 
developer the ability to: 

• Design application icons quickly and easily 

• Edit and export images easily to the World Wide Web 

• Manipulate several images at once without degrading perfoimance 

• View updates from a variety of perspectives simultaneously 

• Import and Export images as GIF, JPEG, PNG,TIFF, and PNM files 

• Plug-in third party tools and filters 

Be Studio requires the BeOS, 16 MB of RAM (32 recommended), 
SMB available hard disk space and a 256-color display adapter. 
Price includes all major and minor upgrades through version 2.0 via 
electronic distribution. 

(SBESTUD) Our Price $99 

Order Tell'free 
800-MACDEV-1 


webAlias 1.0 

by Lakewood Software 

webAlias 1.0 is an 
integrated image map 
editor and anti-aliasing 
text tool for web and 
graphic designers. Use 
webAlias to create 
complete web sites, 
single web pages, and graphic content for multimedia and web 
design projects. webAlias integrates support for line, shape, free 
form, field and button objects, webAlias’ anti-aliasing features 
include support for embedded pictures and gradients in text, as well 
as multiple shadow and highlight effects. 

(SWEBALS) 0urPrice$129 





Music ll’acks 

by BeachWare, Inc. 

A new PC/Mac & Audio multimedia music 
CD-ROM. The clips Include musical 
introductions, fanfares, background music, 
and more. This collection offers you 100 
music clips stored in .WAV format for 
Windows, SoundEdit & AIFF formats for Macintosh and as Audio 
tracks for audio CS players. Ail of the music clips are completely 
license and royaity-freei! Mac System requirements: Mac Plus or 
greater, CD-ROM drive. PC system requirements: Windows 3.1 or 
later, Sound Blaster compatible board, CD-ROM drive. 

(SMT) Our Price $24.95 






MultiWare 

Multimedia Collection 

by BeachWare, Inc. 

Introducing a new Audio multimedia music 
CO-ROM for the Macintosh. This disc is a 
collection of clips ideal for De^op 


Presentations and other Multimedia applications. This incredible collection 
of license-free media clips is bursting with 240-i- color pictures and 
backdrops fICT), 200 -f sound & music clips (SoundEdib, 140-h 
QuickTime movies, and a variety of multimedia tools for use with the 
Macintosh, 

(SMWMC) Our Price $24.95 


HyperGuide 1.0 

by Lakewood Software 

HyperGuide 1.0 is a hybrid 
multimedia authoring tool and on¬ 
line documentation system for the 
Macintosh and World Wide Web. 

HyperGuide provides integrated 
searching, indexing and 
bookmarking features. Supported 
media elements include: rectangle 
and scrolling fields, lines and 

shape fills, most QuickTime-supported image formats, anti-aliased text 
and QuickTime VR movies. HyperGuide also includes an integrated 
screen capture utility and user-configurable slide show mode, 
(SHYPGUD) Our Price $149 




Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT CODE OUR PRICE 


AudicTrack SAUDIOTRK $270.00 

Captivate 4.6 Essential Graphics Utilities SCAPTIV $79.00 

Media Cleaner Pro SMCPUP $359.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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PowerSD 

by Techworks 

The power of an arcade on your 
PowerPC Based on award winning 
3Dfx Voodoo Graphics. The PowerSD 
works with your existing graphics 
card and multi-sync monitor to provide you the absolute in 3D 
performance. Install the PowerSD in your PowerPC (requires one 
available PCI slot in your system) and use the provided pass-through 
cable to turn your PowerPC into a Power Arcade system! 

PowerSD comes bundled with diese awesome 3D enabled games: 

• Quake*: Episode 1 (8 level) by Id Software 

• MechWarrior'*’ 2 by Activision 

• VR Soccer™ by VR Sports (Actua™ for Europe) 

! • Weekend Warrior™ by Bungle 

(SPWR3D) Our Price $249 




Abuse is 360 degrees of side-scrolling action. 

Run, jump, fall and fly in any direction - through 
Industrial corridas, caverns and sewers. Destroy 
enemies in any direction with grenade launchers, 
rocket launchers, napalm and nova spheresi Avoid 
deadly traps with jet packs and turbo tx»st! 

Key Features: 

• Point ^d Kill Interface. Move and arnitiilate mutants in complete 360“ (reedom 

• Blast your way through floors, walls and ceilings in search of the ultimate 
power-up! 

• Abuse is 360 degrees of side-scrolling action, Run, jump, fall and fly in 
any direction - through industrial corridors, caverns and sewers 
(SABUSE) Our Price $51 


Abuse 

by Bungle Software 


1000 Games for 
Macintosh 

by BeachWare, Inc. 

The best Macintosh game disc in the 
entire world, this CD-ROM contains over 
one thousand great shareware and public domain programs. Battle ugly 
aliens, blast apart run-away asteroids, deal yourself that royal flush or 
soive that 3-D puzzle, this dix has it all! System requirements: Mac 
Plus or greater, CD-ROM drive, and 2 MB of available RAM (4 MB of 
RAM when running under System 7), 

(STGM) Our Price $24 




Myth The Fallen Lords 

by Bungle Software 

PC GAMES MAGAZINE’S, Most Anticipated 
New Gfune Award 

The Fallen Lords is a fully 3D real-time strategy 
game of epic battle. A mulbmetric game, Myth; 
The Fallen Lords gives gamers unprecedented 
freedom to view their forces, orbiting around 
the heads of a formation or zooming tn for a 
close-up on savage melee. Myth: The Fallen Lords includes maps 
designed for networking, and alternate networking scenarios like 
Assassin and King of ttie Hill. 

(SMYTH) Our Price $49 


Classic Arcade 

by BeachWare, Inc. 

Ten of your favorite coin-arcade games, redone 
with killer graphics and sounds! Walk through a 
virtual arcade and test your game playing skills 
with these exciting arcade classics, Ten games, 
including Moon Lander, Astro-Boing, Hyper 
Hodxey, Ballistic Avenger, and more. System Requirements: Mac—Color 
Mac wiBn 8 MB RAM, CD-ROM drive. PC 486 With 8 MB RAM, Sound 
card, SuperVGA, CD-ROM drive. 

(SCLA) Our Price $24 



Marathon Trilogy Box Set 

by Bungle Software 

The Marathon Trilogy Box Set brings all three 
Marathon games together in one affordable package, 
with tons of extras thrown in. Besides Marathon, 
Marathon 2: Durandal and Marathon Infinity, you'll also 
receive a staggering 1200 maps, featuring never- 
released Bungle maps and the winners of Bie Infinity 
Mapmaking Contest, Ttie Marathon Scrapbook (a behind-the-xenes look at 
Ihemaking of the Marathon games). Marathon collectables like the Marathon 
3-sticker set, and to top it off, the award-winning game that laid the 
groundwork for Marafiion; Bungle's breaktirough Pathways Into Darkness. 
The Marathon Trilogy Box Set is native to the Power Macintosh, utilizes the 
graphics axeleration of 630 and 6200 machines, is 8,16 and 24-bit color 
capable, and can be played with joysticks and game pads. The package 
requires a 68040 or higher Macintosh, CD-ROM drive, 8-bit color monitor 
(13” recommended), and System 7 or later. 

(SMTBS) Our Price $65 



there'* 


i 


Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

A Zillion Sounds 

SAZS 

$24.00 

Casino! 

SCAS 

$24.00 

Night Sky Interactive 

SNSl 

$24.00 

Trivia Warehouse 2000 

STW2K 

$24.00 


20 


1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 















¥nr Macintosb 
Prof^rammers & De if elopers 



MAGAZINE 


MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with everyttiing they 
need to know about software development. Topics like Rhapsody, Java, 
QuickTime, OPENSTEP, Objective-C, C/C++, Object Oriented Technologies, 
product reviews and much more! 

Subscriptions: 

(MTYRDM) US/Domestic for 12 issues $47 

(MTYRCM) Canadian for 12 issues $59 

(MTYRFM) international for 12 issues $97 

Back Issues: each plus shipping (subject to availability] $10 




MacTech® CD-ROM Volumes 1-12 

• Includes Apple's issues 1-29 (1990-1997) 

• Almost 1600 articles from all 139 issues of MacTech 
Magazine (1984-1996) and through may of 1997 

• improved hypertext, improved indices, and a new THINK Reference Viewer- 
for lightning quick access! 

• New hyperlinks between articles 

• 100+ MB of source code—use them in your applications, with no royalties! 

• Full version of THINK Reference™ — the original online guide to Inside Macintosh. Vols. I-VI 

• 80MB of FrameWorks/SFA archives and the most complete set of Frameworks archives known 

• SprocketT“! MacTech's tiny framework that compiles quickly and supports System 7.5 features 

• The best threads from the Macintosh programmer newsgroups plus thousands of notes, tips, 
snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

(SMTCD12) Volumes 1-12 Our Price $129 
(SMTCD12U) Upgrade from any previous version Our Price $49 







Inside Macintosh: CD-ROM 

by Apple Computer, Inc. 

More than 25 volumes in electronic form. Includes: 
QuickDraw™ GX Library, Macintosh Human Interface 
Guidelines, PowerPC System Software. Macintosh Toolbox 
Essentials and More Macintosh Toolbox, QuickTime and 
QuickTime Components. Access over 16,000 pages of 
information with Hypertext linking and extensive cross 
referencing. 

(BIMCD) Our Price $89 



Order Toll-free 
800-MACDlV-l 

'KI0627338II 



Web site: http;//www.devdepot,com • E-mail: orders@devdepot.com 
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New Books! 



The OffiGlal BBEdit Book 

by Bob LeVitus and Natanya Pitts 

The Official BBEdit Book makes it easy for 
today’s Webmasters to speed their own 
interactive development projects using this 
powerful editing environment. Bare Bones 
incorporates features like floating palettes, 
HTML support, and syntax coloring to 
enhance an already extensive feature set, making BBEdit a leading 
Web authoring tool. Super-fast text processing, easy scripting, wide 
extensibility, strong GREPstyle search-and-replace capabilities, and 
support for 13 languages make it easy to see why so many Web 
developers use BBEdit as their primary authoring tool. 

(BOFBB) Our Price $35 


the Official 
BBEdit 
Book 

■■ V 


Effective C++, 

Second Edition: 

50 Specific Ways to improve Your 
Programs and Designs 
by Scott Meyers 

Effective C-h-, 2nd Edition includes: Expert 
guidance on object-oriented design, class 
design, and the proper use of inheritance 

• An examination of the standard C++ library, including how the 
Standard Template Library and classes like string and vector affect 
the structure of well-written programs 

• Discussions of late-breaking language features like in-class 
constant initializations, namespaces, and member templates 

• Wisdom usually possessed by only the most experienced 
developers 

• Effective C++ continues to be essential reading for every 
developer working with C++. 

(BEFC) Our Price $34 


DeBabelizer 

by Lise Despres and Paul Vachier 

DeBabelizer: The Authorized Edition is the 
official guide for Web designers, 
multimedia creators, artists and production 
specialists whp want to take advantage of 
this powerful tool. 

• Create graphics and images for the Web that dovmtoad fast and 
look amazing 

• Optimize graphics for CD-ROM, video, and animafion 

• Optimize and manage colors using the SuperPalettefTM) 

• Discover DeBabelizer tips and advice from industry experts 

• Master basic manipulation techniques, including rotation, scaling, 
cropping, and text overlay 

• Explore key production techniques in all areas of graphics 
processing 

(BDEBTAE) Our Price $40 
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Symantec Visual Cafe 
Sourcebook 

by Cary A. Jantin and Pam Dixon 

Symantec Visual Cafe, the first visual Java 
development tool that gives programmers a 
sophisticated set of tools. This book teaches 
programmers how to use Symantec Visual 
Cafe to create Java applets. It provides a thorough Introduction to 
the language and gives advanced Java programmers information on 
how to use Visual Cafe to create their own Java development tools, 
PSYMSOUR} Our Price $35 



Web Security Sourcebook 

by Aviel D. Rubin, Daniel Geer and Marcus 
J. Ranum 

Technical tools and techniques tor 
building secure web sites and 
applications 

This book shows web masters, web 
managers, and web designers the hands on 
programming techniques necessary to build secure web sites. 
Readers will learn how to secure the server, use firewalls and 
cryptography, write secure Java applets and CGI scripts and more. 
Companion Web Site includes source code examples plus updates 
on the latest security threats and techniques. 

(BWEBSER) Our Price $26.99 

Building An Extranet: 
Connect Your Intranet With 
Vendors And Customers 

by Julie Bort and Bradley Felix 

Building an Extranet will help companies use 
their Intranet capabilities to supply information 
to selected customers and vendors through a 
secure Extranet, This book provides complete information and working 
details for building the network behind Intranets and Extranets, 
designing the applications, and getting everything up and running. 
(BBLDEKT) Our Price $26.99 


The Java FAQ 

by Jonni Kanerva 

Java FAQ provides an insider's view of the 
Java’” technology by posing 
and answrering the most important, frequently 
asked questions about the Java programming 
language, Java applets, and Java stand-alone 
applications. The Java FAQ is unique in that it 
draws from the tens of thousands of questions sent to 
<Java@java.sun.com> and provides authoritative answers direct 
from the creators of frie Java programming language at JavaSoft. 
(BJFAQ) Our Price $25.13 
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APPLE ENTERPRISE SOHWARE 


Getting Started With WebObjects 

by Apple Enterprise Software 

If you're a first time user, start here to learn the basics of how to 
create and run WebObjects applications. 

(BGSWO) Our Price $14 

WebObjects Developer's Guide 

by Apple Enterprise Software 

A guide to building and understanding WebObjects applications. 
Takes a close lorrit at the WebObjects scripting language. Additional 
sections explain the WebObjects architecture and tells you how to 
integrate your code into the request-response loop, create reusable 
components, create client-side components, take advantage of 
powerful Foundation Framework features, and more. Riled with 
example code. For all WebObjects programmers. 

(BWODG) Our Price $16 

D'OLE Developer’s Guide 

by Apple Enterprise Software 

Distributed OLE is available today, and this book shows you how to 
use it. Using real-world examples, the book steps you through the 
process of making your OPENSTEP objects available on Windows 
through OLE. 

(BDOLEDG) Our Price $22 

Discovering OPENSTEP, Mach 

by Apple Enterprise Software 



Object-Oriented 
Programming and Objective C 

by Apple Enterprise Software. 

An inboduction to the principles of object-oriented programming in 
OPENSTEP and the official description of the Objective-C language. 
Objective-C is easy to learn and use because it adds very little 
syntax to the C programming language. It’s dynamic nature allows 
you to accomplish things not possible in most other object-oriented 
languages. For any OPENSTEP programmer. 

(BOOPOC) Our Price $24 

Working w/ Interface Builder (for eof) 

by Apple Enterprise Software 

A hands-on, award-winning book designed to help you get your job 
done with the updated Interface Builder, released with NEXTSTEP 
3.3 and the Enterprise Objects Framework 1.1. For any programmer 
using Interface Builder to design objects that truly work in 
NEXTSTEP. 

(BWIB) Our Price $24 


Introduces programmers to NeXT’s OPENSTEP 4.0 Developer product 
by guiding them through the creation of toree applications of 
increasing complexity. The tutorials demonstrate and explain 
programming techniques, Objective-C tundamentals, common APIs, 
and usage of the developement tools. Along the way they present 
summaries of important concepts and paradigms. The book also 
includes a chapter directing readers to programming resources, 
further intormation, and services such as training and support. An 
appendix offers a concise discussion of object-oriented programming. 
(BDOSTEPM) Our Price $15 


Using EOF 2.1 w/ OPENSTEP (Mach & Windows) 

by Apple Enterprise Software 

Using Enterprise Objecte Framework with OPENSTEP describes liow 
to create an Enterprise Objects Framework application on 
OPENSTEP. It includes a tutorial and a chapter on creating a user 
interface for an OPENSTEP Enterprise Objects Framework application. 
(BUEOFO) Our Price $14 

EOF Developer's Guide for EOF 2.1 (Mach & windows) 

by Apple Enterprise Software 


Discovering OPENSTEP, Windows 

by Apple Enterprise Software 

Discovering OPENSTEP provides an introduction to OPENSTEP 
programming on Windows NT. It guides the reader through the 
creation of three applications of increasing complexity. Along the way. 
it explains concepts and Illustrates aspects of Objective-C, OPENSTEP 
classes, the development environment, and programming techniques. 
A short appendix offers a summary of object-oriented programming. 
(BDOSTEPW) Our Price $16 


The Enterprise Objects Framework Developer's Guide describes how 
to develop database applications using the Enterprise Objects 
Framework tools and classes. It includes an architectural overview of 
the product, and descriptions of programming tips and techniques. 
An appendix offers a summary of Entity-Relationship Modeling. 
(BEOFDG) Our Price $24 

EOF Developer's Guide for EOF 2.0 {BE0FDG20) Our Price $24 
EOF Developer's Guide for EOF 1.x {BEOFOG1>0 Our Price $24 
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Covers the basic architectural principles 
of Rhapsody: the Mach microkernel, 
object-oriented programming, and the 
elements of a modern OS such as 
preemptive multitasking, protected 
memory, and symmetric multiprocessing. 
Also shows ways of getting to this new environment—Objective C, 
conversion tools, and the integration of Java—to develop Rhapsody 
products. Paperback, 450 pages. 

(BRDG) Our Price $35 


Rhapsody Developer’s 
Guide 

by Jesse Feiier 


The Way Computer 
Graphics Works 

by Oiin Lathrop 

A compiete guide to mastering 
computer graphic basics, it is written 
in a frank, down-to-earth styie 
covering everything from how 
computer graphics are different from 
fine art and photographs, to modeling, 
pixels, and the principles of animation. 
All of this is done without resorting to mind-numbing equations and 
impenetrable technical jargon. 

(BWCGW) Our Price $29.65 


the way # 
computer 
^graphics 
works 





Debugging Macintosh 
Software 
with MacsBug 

by Konstantin Othmer and 
Jim Straus 






RO 


MacsBug, from Apple Computer, Inc., 
is the leading debugging software 
program for the Macintosh. This 
booK/dtsk package is an all-in-one kit 
for using MacsBug, Chapter 1 introduces MacsBug and describes 
the contents of the rest of the book. Ctiapter 2 describes how to 
install MacsBug and enough low level details about Ihe Macintosh 
so that you can use MacsBug. Includes MacsBug 6.2 on disk, 
(BDMSWM) Our Price $31 


Order Toll-free 
800-MACDiV-l 


ieoM22-33ai| 


Check out our Web site! 

;; • Full product descriptions ■ Hundreds of more products 

4; http;//www.devdepot.com 



Practical Object- 
Oriented Development 
in C++ and Java 

by Cay S. Horstmann 

This book offers advice on real-world 
ways to use these powerful 
programming languages and 
techniques. Using the Unified Modeling 
Language (UML) methodology, expert 
Cay S. Horstmann gives you clear, concise explanations of object- 
oriented design, C+4-, and Java in a way that makes these potentially 
daunting operations more accessible than they've ever been before. 
(BPOOD) Our Price $31 


WebMaster in a Nutshell, Deluxe Edition 


by O'Reilly & Associates, Inc, 

Cross-platform, completely portable, and lightning fast, 
the CD-ROM is an invaluable addition to the 
webmaster's toolbox. The CD-ROM contains the Web 
Developer's Library—the full text of ttie latest editions of five 
popular O'Reiliy titles; "HTML: The Definitive Guide, 2nd Edition"; 
"JavaScript: The Definitive Guide, 2nd Edition"; "CGI Programming 
on the World Wide Web"; "Programming Perl, 2nd Edition"; and 
"WebMaster in a Nutshell." The Deluxe Edition also includes a 
printed copy of "WebMaster in a Nutshell," the all-inclusive quick 
reference that belongs next to every webmaster's terminal. Includes 
CD-ROM & 356 page book. 



Requirements: The CD-ROM is readable on all platforms, but requires 
a web browser that supports HTML 3.2, Java, and JavaScript. 
(BWMNUTD) Our Price $62 



Designing 3D 
Graphics 

by Josh White 






In this powerful book/CD-ROM package, 
top computer graphics artist Josh White 
tells you everything you need to know to 
create sophisticated real-time 3D 
graphics for computer games and 
virtual reality. This book contains the in- 
depth knowledge of software tools and 
hands-on modeling techniques that Josh White has learned while 
creating artwork for over 20 commercial games, including Descent, 
Zone Raiders, Locus, Legoiand, and others. 

(BD3DG) Our Price $35 
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Wireless For 
The Newton ■■ I 

by Julie McKeehan and Neil Rhodes 

A book that picks up where 
Programming for the Newton left off. 
teaching the reader how to develop 
Newton software on the Macintosh. The 
enclosed floppy disk provides a sample 
application, as well as a fully functional 
demonstration version of Newton Toolkit. 

• Learn to develop Newton software on the Macintosh 

• Hands-on Newton environment training with sample code 

• Includes disk with sample source code for a Newton application, 
as well as demonstration NTK - the complete development 
environment for the Newton 

(BWIRELESS) Our Price $31 
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JavaScript 
& Netscape Wizardry 

by Dan Shafer 

The perfect book to Show you how to 
turn Netscape into your 
own personal, 
customized operating 
system. Provides the 


inside tips and 
techniques for making your Web 

pages much more attractive. Shows you how to use all of the key 
features of the JavaScript language, including objects, methods, 
properties, events, and much more. Includes CD-ROM with 
numerous Interactive scripts written in JavaScript you can add to 
your Web pages today. A complete set of the best Java applets. 
Useful plug-ins designed to supercharge Netscape and resources to 
help JavaScript programmers. 

(BJNWIZ) Our Price $31 







JavaScript 1.1 
Developer’s Guide 

by Arman Danesh and Wes Tatters 

Written by developers for 
developers. An advanced 
guide to creating 
professional Web 
applications with 

JavaScript 1.1 as deployed in Netscape 
Navigator 3.0, Microsoft Internet 
Explorer 3.0, and LiveWire. Includes CD-ROM with Sun's Java 
Developer's Kit, JavaScript and HTML Editors for Windows and 
Macintosh, 20 contributed ready-to-run JavaScripts and JavaScript 
examples from the book. 

(BJSDG) Our Price $44 



Developer's Guide 


Web site: http://www.devdepot.com • 



Linux Configuration 
& Installation, 

3rd Edition 





by Patrick Volkering, Kevin Reichard, and 
Eric F. Johnson 
Linux, the leading UNIX variant. 
has garnered loads of attention ' 
within the UNIX community. The 
amazing thing about Linux is that you don't need a 
workstation to run it. Linux Configuration & Installation. 

Second Edition lets you run Linux today. Program with Linux using C, 
C-r+, Perl, and Tcl/Tk. The 2 CO-ROM pack offers one of the most 
popular Linux distributions. Slackware 96. and comes directly from 
Patrick Volkering. the creator of Slackware. 

(BLCI2) Our Price $35 
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Increasing Hits and Selling 
More on your Web Site 

by Greg Helmstetter 
Written especially for entrepreneurs, 
corporate marketing memagers, small 
business owners, and consultants, this 
valuable guide gives you rare tips and tricks 
you need to know to make your site a commercial success. 
(BIHSMWS) Our Price $22.45 

HTML Sourcebook, 3rd 
Edition 

by Ian S. Graham 

Critics everywhere agree, HTML Sourcebook 
is the best guide to HTML for Web 
professionals. That's because no other book 
makes it so easy tor you to quickly master 
all the commands, tools, and expert 
techniques you need to create cutUng-edge 
Web page documents. Completely revised and expanded by nearly 
50 percent, this new third edition of the best-selling guide to HTML 
gives you the complete lowdown on all the changes and 
enhancements to the HTML. HTTP, and URL standards. 

(BHTMLS) Our Price $26.95 


Teach YourseN Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L Perkins 
with Timothy Webster 

Add interactivity and multimedia to Web pages! 
A step-by-step guide to make your Website 
come alive. Learn the basics of programming 
Java applets and the concepts behind the Java language. Includes CD- 
ROM with a limited version of Roaster, the first commercial, integrated 
applet development environment for Java for the Macintosh! 
(BJAVAMAC) Our Price $36 
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Web Publisher’s Design 
Guide for Macintosh, 
2nd Edition 

by Mary Jo Fahey 

This is Ihe only book that takes you 
step-by-step through real projects 
designed by talented new media 
artiste. Internet design experts share 
their design secrete and art files Oook 
for art files on the companion CD-ROM 
by artist’s last name). This expanded new edition includes 
Photoshop, Illustrator and DeBabellzer tricks from the first edition 
plus countless new ways to liven up your Web pages with 3D 
graphics, sound, movies, and much more. 

(BWPDG2) Our Price $35 


Getting Hits-The 
Definitive Guide To 
Promoting Your Website 

by Don Sellers 

Getting Hits explains in easy-to- 
understand language the underlying 
concepts behind the art of Web site 
promotion. Just a few of the topics 
you'll learn include; using search 
engines with URL's; finding related Internet groups or lists; 
understanding the nuances of click throughs and ad rates; and 
distributing press releases to key Internet contacts. With this book, 
you’ll go beyond the conceptual and actually follow real-world tested 
promotional campaign strategies. Bring the world to your Web site! 
(BGHITS) Our Price $17.95 
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OPTIMIZING 

CODE 



Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembiy Language 

by Gary Kacmarcik 

Take full advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques. Learn to produce 
faster more robust software! 

(BOPTPPC) Our Price $35 
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HTML For The Worid 
Wide Web, 2nd Edition 

by Elizabeth Castro 

Teach yourself Hypertext Markup 
Language the quick and easy way! This 
Visual QuickSlarl Guide uses pictures 
rather than lengthy explanations. You'll 
be up and running in no time. If you 
need to learn HTML fast - this is book 
is for you. 

(BHTMLW2) Our Price $16.15 



Macromedia 
Shockwave for Director 

by Jason Yeaman and 
Victoria Dawson 

The complete resource for creating 
Shockwave movies on the Web. This 
hands-on reference makes it easy to 
create Shockwave movies and put 
them on the Web. Expert tips from the 
creators of Macromedia's first 

Shockwave movies, together with detailed examples and instruction, 
provide everything you need to get started. Includes CD-ROM. 
(BMSFD) Our Price $27 


Programmer’s Toolbox 
Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentials, 
by Addison-Wesley Publishing 

Get quick access to reference pages for over 
4,000 Toolbox calls in your system software 
from their development environment. Essential 
information for Macintosh software developers. Hypertext links allow 
programmers to view related topics easily. The ultimate electronic 
reference tool for Macintosh programmers. 

(STBASST) Our Price $89 




JavaScript For The 
World Wide Web 


lAVAXIClrl Jeremy Schneider 

This book takes an easy, visual 
approach to teaching JavaScript, 
where pictures guide you through the 
software and show you what to do. 
Works like a reference book, you look 
up what you need and then get straight 
to work. No long winding passages, concise, straightforward 
commentary explains what you need to know. 

(BJWWW) Our Price $16.15 
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Metrowerks CodeWarrior 
Programming 

by Dan Parks Sydow 



Includes CodeWarrior Lite, and Fuii Coverage of PowerPlant™. The 
best information on Metrowerks CodeWarrior, giving full coverage to 
the Gold Edition. CD includes Code Warrior Lite. 

(BCWPROG) Our Price $35 


CodeWarrior Software 
Development Using PowerPlant 

by Jan L. Harrington 



C++ programmers will learn to develop object-oriented software 
applications for the Mac and Power Mac using the PowerPlant 
environment and the classes that support it. Covers CodeWarrior 8. 
Included CD-ROM contains source code for alt the programming 
examples in the book and Metrowerks CodeWarrior Lite. 
(BCWSWDEV) Our Price $31 


Inside PowerPlant 

by Metrowerks 

Create PowerPlant applications using the CodeWarrior IDE and 
PowerPlant Constructor. Full descriptions of major PowerPlant classes 
and resources. Included are the PowerPlant Conshuctor Manual, 
including View,Texfrraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant. 
(BINSPP) Our Price $34 
SEE RELATED CATEGORY; Dev. Environment 


Check out our Web site! 

■ Full product descriptions • Hundreds of more products 

http://www.devdepot.Gom 
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C++ Programming 
with CodeWarrior 

by Jan L. Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Learn 
object-oriented programming techniques 
using C++ as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior. 


(BCPPCW) Our Price $33 




Learn C on The 


Macintosh Second 


Edition 

by Dave Mark 


New revised edition! Easy-to-understand - 
everything you need to start programming. 
Updated and enhanced exercises that lead you 
step by step. You'll learn function, variables, point datatypes, data 
structures, file Input and output and more! Includes CD-ROM with 
Metrowerks CodeWamor™ Lite. 


(BLEARNC2) Our Price $33 


Order TolMree 
aOO-MACDEV-l 


TO338I) 


MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with everything they 
need to know about software development. Topics like Rhapsody. Java, 
QuickTime, OPENSTEP, Objective-C, C/C++. Object Oriented Technologies, 
product reviews and much more! 

Subscriptions: 

(MTYRDM) US/Domestic for 12 issues $47 

(MTYRCM) Canadian for 12 issues $59 

(MTYRFM) International tor 12 issues $97 

Back Issues: each plus shipping (subject to availability) $10 
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AppleScript Language Guide 

by Apple Computer, Inc. 


A complete reference for anyone using AppleScript to modify existing scripts or to write 
new ones. Contains useful information for programmers who are working on scriptable 
applications or complex scripts. Feahjres detailed definitions of AppleScript terminoiogy 
and syntax In the following categories; Value classy, commands, objects and 
references to objects, expressions, control statements, handlers, and script objects. 
Includes many sample scripts, discusses advanced topics such as writing command 
handlers for script applications, the scope of script variables and prq)erties declared at 
different levels in a script, and inhen'tance and delegation among script objects. 

(BALG) Our Price $26.95 
SEE RELATED CATEGORY: Scripting 


AppleScript 
Applications: 

Building Applications with 
FaceSpan and AppleScript 

by John Schettino Affiliation & Liz O'Hara 



Build complete AppleScript applications using 
FaceSpan, a user interface development tool 
that makes AppleScript applications truly 
“Mac-Like". Uses a step-by-step approach 
to demonstrate techniques for building 
applications through illustrations and 
samples. Provides Graphical User Interface 
{GUI} design tips and practical approaches for 
implementation. Contains one CD-Rom with 
AppleScript 1.1, a demonstrations version of 
FaceSpan 2.1, source code for all example 
applications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan. 

(BAPSCAP) Our Price 




Special Edition 
Using CGI, 

2nd Edition 




(o) 
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CGI 


SccoIkI f jJtlHHl 


and Robert Niles 

This complete reference provides 
professional Web developers and advanced 
personal users with the latest information 

on using CGI (Common Gateway Interface) to interact with databases. 

• Explains client and server uses of CGI 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI security 

• Features separate chapters devoted to language-specific tips, 
tricks, and traps 

• CD ROM is loaded with the HTML and CGI sample code from 
the book 

• Includes applications for guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 





Java in a Nutshell, 2ncl 
Edition 

by David Flanagan 

A detailed overview of all of the new features 
in Java 1.1, both on a package-by-package 
basis and in terms of overall functionality. A 
comprehensive tutorial on "inner classes" 
that explains how to use all of the new types 
of inner classes: static member classes, member classes, local 
classes, and anonymous classes. Practical, real-world example 
programs that demonstrate the new features in Java 1.1, including 
object serialization, the new AWT eveni handling model, 
internationalization, and a sample Java Bean. 

(BJNUT2) Our Price $17.95 

AppleScript Finder Guide, English Dialect 

by Apple Computer, Inc. 


(BSEUCGI) Our Price $44 



JavaScript 

MAcimTOH 


JavaScript for the Macintosh 

by Matt Shobe and Tim Ritchey 

Allows non-programmers to take 
advantage of the power of 
Netscape Navigator. Expand the 
capabilities of your Web page, without 
having to understand C or C+-t-. CD-ROM 
contains "Wizlets" that allows you to easily 


create your own JavaScripts. Takes you step-by-step through 
programming cross-platform JavaScripts. Details how to create 
JavaScripts for JavaScript-aware Web browsers. 
(BJAVASCRPTJ) Our Price $40 


Provides definitions for Finder object classes and commands. Write, 
record, or run scripts that trigger the same desktop actions that you 
trigger using the keyboard and mouse. 

(BAFG) Our Price $17.95 

SEE RELATED CATEGORY: Scripting 


Inside CodeWairior Professional 

by Metrowerks 

Includes CodeWarrky IDE User's Guide. This is the printed version of the 
documentation provided on the CD. Covers CodeWairior Professional 
Release, the debugger and associated tools. 

(BINSCWP) Our Price $34 

SEE RELATED CATEGORY: Dev. Environment 
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3D Graphics 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 3D graphics into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extension to the 
Mac OS for Power Macintoshes. CD 
contains the complete QuickDraw 3D 
system itself and a complete database of the QuickDraw 3D API, 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. Book/CD-ROM, 640 pages. 

{B3DGRAP) Our Price $35 


Tricks of The 
Mac Game 
Programming Gurus 

by McDomack, Ragnemalm, Celestin, et al. 

For beginning to expert game 
programmers. Complete overview of all 
the necessary components of game 
programming on the Macintosh. Packed 
with valuable tools, utilities, sample code, CodeWarriorTw Lite and 
game demos. QuickDraw 3D and Power Mac optimization and inside 
info on how Glypha III was created. Hundreds of tried-and-true 
tricks, tips, and insider secrets from well-known Mac game 
programming experts, 

(BTRICKS) Our Price $45 


Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. 

Enhance your software's color 
capabilities with step-by-step 
instructions. Augment the color support 
supplied with QuickDraw, and QuickDraw 
GX. Use the Pallette Manager to get the 
best colors on limited displays. Match 
colors between screens and input/output devices (scanners & 
printers). CD includes a complete reference information in both 
QuickView and Acrobat formats. Plus, a sample application 
demonstrating GoiorSync programming techniques. 

(BADVCI) Our Price $33 


Black Art of Macintosh 
Game Programming 

by Kevin Tieskoetter 

Develop your own 3D games in 
C on the Mac. Includes CD with 
project files for both Symantec 
C and Code Warrior. Create 
freeform texture-mapped games and 
polygon graphics. Control dynamic source 
code — all compatible as native to the Power Mac, Write directly to 
the screen, bypassing QuickDraw. 

(BBLACK) Our Price $35 


..BlickAfiirf \ 

MACINTOSH^ 

GAME 

PROGRAMMING. 
































































































































COBybtamole .. . , „ .. 

.JOIBE™. 

.31,00 


.BBAMAl ... 

..fl5,DO 

Clans Home Page Companion .... . ... 

..........JCrt>C.. 

. 2E.Bfi 

Computer HrtT^Jtpmlf .. 

.„.tiniv . 

99.4fi 

Developing C3i Applications wfth Reri 

. BOCOA 

_ zero 

E-Man EssBiitiats .... — .. ., . 

........ :PE"-IE . 

2Z45 

Rminiiai: F ktHd Alylif ... . 

BaiAL 

13.45 

ilnikml fvi JSvS . 


3SM 


.BWSWNT . 

13,45 


BTHENET 

,22.50 

htarni^ Inr DonvTiie!i 2rMJ . , .. 

nmiiM?.. . 

17.99 

Irttenwl tor Dummief Quicit ftefertnee ... 

. JOUMOCIl . 


Intfirmrl'lar Macs for Dummies ... ... 

. BNETDUM.,. __ 

. 17,95 

Intemei tw Macs for Uijmmlw Edrtinri 

.....BIFWDBE-. 

,35.00 

in|«mfit Pnvyiw - rr_ir_, .. 

.ePWRTOOt..... 

.....30,00 

Inlamet FtiWIshlnp wlte Adobe iftffnfw ,.,,.r,.. 

.B1PWAA.«„. 

. 35.00 


.. BNETDa.i^ .. 

..3100 

Intranel Web Dev.: Enterprise Attefnalwes b Clieniy^iarvflf .. .. 

. BlimVD .. 

44.DQ 


. BJAWES^.... .. 

, iT.ro 

Java in a MutdhiHi...... 

.BJAVANUI .. 

1145 

Java Latifluiige API SufBf Bite.. ... 

JXAS.m __ 

.53,00 


0JPWC .. 

. ^LSfl 


ajscfl... 

..4100 

ftv Madnb^ .. ...... 

.aiAUttSOFT.. . 

« .....40X10 

1 ftWTi Ifnil m thi 

. BIKTMI .. 

. ,2firo 

1 laiin iftuA Jiri ttiA Marirr^^. 

....... BUAVA , . 

31.00 

Mas&ring IMecape 2.0 tor Mactmasni, Second Edlbn. ... 

. BMAStCT? „ 

.38 00 

Ufui^irw^ Ihfl Irnfm^ Of yt^ir Wifii]i 5 U|e ... 

. BMtVWS . 

. 26.95 

UV0 htflitui try liiinnyM 


....... 17.95 

Mosaic lor tXtmmlPs .,,..... 

,, BMOSaii* 

........17.99 

14etOwt , , ..... ,n . M. 

.BfTTCHAT ... 

17.00 

NeiClJiecte tustan HsncbOOlt ..-. 

.strront.*... 

.„... 45.00 

I%| Omck Kefsfonco........____ 

_FiPFTnnrF.. 

.17.99 

l^riinQ and Mariaglrio Websites... „ 

...EMHAHWEB. 

.3S.0D 

Pfpitiv^ m ittn IrtpyiHe .- 

RPYP 

..„,«.2099 

Providing futomeft Servteeu via the MacOS . 

. „...BPnOV1€T. 

..31.00 

Piiijiu^n n pfi !rtw W(* . 

_RWFnn IB 

.31.00 

TfTAPVW l'ViOl?fti«nrtlr?. . ^ , ,,, 

_BTCPtMUni 

soro 

yiyirRnH .Ijh^ ri 91 rttryi? ... 

.jUAUMUttc. . ._ro.Da 

TTid lifl«ii€!t Ptim...... . 


—.,35.00 

ttH? mtetnef Slralegic Ptm ........ 

. ..,. 

_ 

22.45 

Ttia Webtttenjiiater ..., „ ...i,-, ,,, 111 ,,,, ,■ ,, ■, n.„ n, ,,,, 

_ 

- ^^45 

1 hvlnr^n tnri Pi liriii In Hiiw ii iiilfcilln]| 

niiiiFti 

99.as 

liSir^ faiiiATMl , . . 

nitN 

—,,,.40.00 

Vifeb Tinfe srel Tedmiques ...... .. 

. .BWett . 

rooo 


BWEBrt^ 

22,45 

VJMi Uarlo^Big fVinidln^ . .. 

RAMra 

.. rooQ 

Web Page Scriplk^ Tecbnioiiei ... 

.. . .BWBPST .. 

45,00 

Wb with Adobe Acrobat atl lltF . 

.BWPWAA 

roro 

WQhWtewlnQ 

BWWEAV 

^.45 

Watnastef Maclntosb ..... ....... . ..... 

. BWEBHAS 

..^26.95 


Scripting and SoJutions 


AppieScnot Apptcabwis: Built^fig Apps witn FaoeSdon __. . 

BftPRRAP 

„.31,00 

AppteSdIfri SciipflnQ Addiltons . 

.Ftsemnn.. 

..17 05 

Applied Macintosh Scrtpdng .. , „,„ ,. 

.iwmiEO,™.. 

™«,...31,00 

CompietB HyppCard 22 i-tendbooK. .. .™. 

-.BHVPRflDS .. 

.31.00 

rjpmpfcjtfl MyiMjfTjilIt ? 7' . 

(WVPOtffi. 

31.00 

Danny Goadnwi'a Appte Guide Sfarler Kit.. 

.BOGACSK. 

__31,00 

HyperCard Sach. Oesipri...-..... _ 

..bhvfsta.. 

, , IfllW 

ff¥ MnruilnHh ,. 

R.lAWWr3PT 

40,00 

fVjit Ouieft Hryforence.......... 

.BPEBUIB^. 

. 17.99 

teat World Atitite6i4d0.. .... 


_3S.I30 


Technical Reference 


Adive ,i3«a............. 

.BAcfjAVl... 

.23J6 

AmaLm filfkil LfclJulfrMuL 

BCXIHAIC.,.. 

.14.36 

M il ttinan irisierface Oe^ .. ... 

.BAHO .. .... 

___zaro 

Btaidk Art at Mic Game Rognmmirm ..................... 

. BaACK. 

.3S.OO 

(Ink* f« Diimmiwi. . . 

.BCPPOUM.... 

22.46 

Cirtr riiimftiirtfiUni i . 

.0CDyi.„ . 

. ..17.95 

Derttoping Ohioci Oriented Soliwefe twr tee Maciite^—--....... 

ExiendinQ tiw Mac Tpoidok.......—... 

BDCvm, 

..BETVfT 

.26.06 

22 M 

Rjundaljoiis of Maclnbsfi Pibgranmifig...... 

.REOUhlD 

.35 lD 0 

Fraomeni ot itoij Irnaflinatlcn.—, 


.3510 

Guide Id MflCJhtofiSi Sotlwcra Localizaton..... . 

.BLOCAUZ..., 

.„-2126 


yune iQ Msaniogn aysram r-o,,.,. . 

Irti^ ^pfiJnlalk ,,, . 

....uijisf-n.-.. 

....S/^TALR. 

. 

.31.00 

tnsipe the Msoniosn GariimLiiicaiiprisTQoIxix.,,.——.^—. 

.BCdUM. 

ZZ.45 

LasflrWntET Fteterwice ............ 

.BLASERREf.. 

..17.05 

Learn D++pn tee Madntosti ............ 

.BURHCPP.,._..,. 

35.00 

tfwn C rm tep Mf^p^rnrl^^ni I'll RiWm > 

.BLkARNCl.. 

.31.00 

Lepm C en tee Madntnsh, Znd Fditian...._ 


.33.00 

Mk Piuyi iriiiiio tr^ Duii'i' '■■- .....,... . 

. . 

..17,95 

Marinin^ f! Programnwr Primer Ubhine 1... 

.ni;tPFttMi 

.24ro 

hArkilreUi n Prnrw^iminiv^Prfrw^ .. 

,.BCP«M2 

. Z4.Z5 

r 

1 

j { 

j 

i 

1 

: 3 

.bole?. 

. 40.00 

lyfcvnnimn PAc^r Pwi^tTOiifnf] nni¥iAr ure itt\a 1. 

SPASCPRt 

2125 

Msciniosli Programming Secr^ 2n<l edUion .. 

. ...iPSECRET... 

.2170 

Madfttoah Programming lacnniqucs ..... 

.8PTBCH.,. ... 

_ .31.00 

Miciosott Visual J++ 1,1 Sotaxobpok....... 

.flMVJS.. 

.3S.D0 

More Mac programrrung Techniouse.... 

.BMOItIBCH. 

.34.00 

MetwoiH PPEmtiBra kindle ...... 

.BNEIFB.. 

..59,00 

Newton Pragramming Guide....... 

.bnewtpguid ....... 

.40.00 

Object Driantw! Prnfjrainniing Desi^...... «. 

. BOOPHiOOeS. 

..20,06 

flptlmlTlng PpmierPr; Cmrifi ,.,.. . 

.BflPIPPC.. 

.35.00 

Pe*! Q^4c^< Rpfriferjnr . 

.EJP£RLREF,..,„. 

.17.99 
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....BPSUMREf,,. 

..29ro 

hnNerIxxik Digitaltiorr^sCkirie.. .......... 
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... ...22.40 

PowerPC Ptogrammar's Toowt,.,-.—........... 
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. mm 
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. BFAMIV,.... 

.^^40 
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....2425 
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_BPROAT .. 
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. 
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l8flcn Yoursetf Macimosti G++ in Days.- - 

tBGhntcaa imroducJiDn a the MaciniDsn Family ,: . ... 

100 on Sofltfiare Design 

Writing Local^ble Sottwanc... 
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_BSCfTMTB..31.00 

.BCPPZID...m99 
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.BLOCAL.2425 
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3D Grapbics-Ttps, Treks. 5 Tettenkyjiis...... 

.S3DGm..... 
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A Pra^nESTt rf Its II knagirHlDL . . . . . 
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Cf) hflM Riitile tn Mi4tiii»d3 Ai#mf¥ig __ 
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Garry GnQdmai*sAppte Gi^ Starter 1^ .. « . 

Damy Soodman’s Madrasssh Hantoook...... 
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.eGOOOtB. 

.. 

..roiM 
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...MTFWSC.. 
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.MTFWQACK_—. 
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[irapWe Gem* P _... _ .... ^ .. 

..,.fl6FMS2. 

,-,4400 

(te^phin 4 , . 

. .flGCMSA... 

,44,00 

Graphic Gams V........... 

RRrMq.5 

.44.00 

lltfifil-D Bpmyiljivt ....,,. 

.BltJFDREV. 

,., ,40.00 

insicte Director 5 wim ungo tor Macinioah .-... 

...0ID5WLM. 

.44.00 

1 ptn Wljjhf uiifti ._ 

.BLAIE,.. 

26.95 

Mac Hfltmnflm Rwiriw ._,_. 

.BBAIH. 

11 JO 

Mxramecia Dimctra' Lingo Woik^Dp, ?nd FtHion . 

.SM0UW2. 

40.00 

Mac Screamef: the Utimate MaoniCicili SuperdiaQlng Kit... 

....rootAM.. ...... .. 

,._31.D0 

Macintosh Cn^ Cour^.. , . .. . « 

.BOHASH. 

26.95 

MAriTerhBiMtk ... .,... 

.MIBACIOSS. 

10,00 

fctjc'unrtd ;ihirertP UvTinlrKn PrngrAfnning Rnnk. 

.BULTMAC... 

.36.00 

MAnAT/iN VI rrr.ftAU 

SMAOA93... 

_9,95 

AAiitmedg Ikithofiig; Buftfcig and Devetopng Ppcumenlt..... 

BMMAmtt.... 

.31.00 


MuHiinala Slater Kt kf Uadntofih 

PnM rmm Fjiperience. 

ResRit tohptett. Second Edition 
Sad Macs. Qombs and [teasteis 
Standsnis For Online Communication 
Thfi Etemente ot E-Mail Style. 

TN Software [>ei^per^s S Menteter's Legal Comgeriop,.. 
Teg m Software Desifln ______«... 



Trtete ot tne Mac Qams Gmis. 

zen and the Art of Resooroe Edtllng- 


^BSOAMLC. 

BTRIOG^.. 

. 0SW)RE„„«... 
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... .33.00 

—.zero 

...... , 45.00 
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30 1-800-MACDEV-1 • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 











































































































































































































































































































































































All entries in this index are alphabetized. For your convenience the product names 
are bold, book names are italicized and company names are In plain text. 


1000 Games for Macintosh......... 
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The NEW BBEdit 4.5! 


It^oesn't Suck 

'km 


There has never been a 
better time to buy 
BBEdit. 

Upgrade from BBEdit Lite, 
Codewarrior^ MPW, 

Symantec C++ or a number 
of other products for just $79. 

I'his offer is available direct 
from Bare Bones Software, Inc. 

To order, call us at (617) 778-3100 
or visit us online. 




<http://www.barebones.com/> 



Bare Bones Software, Inc. 

RO. Box \(m, BtHlford, MA 01730 • main fi 17-778-3100 * fax fil7-'778-3111 


BBEtlll is a Irademark of Bare Fiones Software, Inc ‘It Doesn't Sirk ’ is a regisfered trademark of Bare Bor>es Software, [nc. ® 1997 Bare Bones Software, he. AH rights reserved. 



































CodeWarrior Professional fielease 2 . Just out and 

-re-ady for some seriousi industrial-strength-programming- Thi; 
is the only Integrated Development Environment that allows 
you; to edit-i compile and debug Cn C++i Java and 'Pascal progran 
for multiple target processors and operating.systems- Ue're 
still the codeuriter>s best friend and now we're be.tter tha^ 
e V e r. H e r e' s wh y! ' 

* *v, ■ I 

Xportable. project files — may be used interchangeably 
between HAC and Uindows platforms 

Xfile compare and merge — select two files to graphically 
view differences and merge changes 

^browse across subprojects — source code_br-ouser works 
i^acrosstargets and subprojects • | 

You can co.unt on CodeWarrior Professional Release 5- We're 

\. 

powerfulT proven! easy-to-handle and we've had ail our shots- 


CodeWarrior 

Q.r'k 


your -ferrif 


o r 


our "specials 

at Developer Central at HAC lilorldi San Francisco-. 


metrowerks 


www-metrowerks-cor 









